SessionParameter 建構函式

參考

定義

命名空間:: System.Web.UI.WebControls

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

初始化 SessionParameter 類別的新執行個體。

多載

SessionParameter()	初始化 SessionParameter 類別未命名的新執行個體。
SessionParameter(SessionParameter)	使用 `original` 參數所指定的執行個體值，初始化 SessionParameter 類別的新執行個體。
SessionParameter(String, String)	使用指定的字串識別要繫結的工作階段狀態名稱/值組，初始化 SessionParameter 類別的新具名執行個體。
SessionParameter(String, DbType, String)	使用指定的名稱和型別，並且將參數繫結至指定的工作階段狀態名稱/值組，初始化 SessionParameter 類別的新執行個體。這是用於資料庫型別的建構函式。
SessionParameter(String, TypeCode, String)	使用指定的字串識別要繫結的工作階段狀態名稱/值組，初始化 SessionParameter 類別的新具名且為強型別 (Strongly Typed) 的執行個體。

SessionParameter()

初始化 SessionParameter 類別未命名的新執行個體。

public:
 SessionParameter();

public SessionParameter ();

Public Sub New ()

範例

下列程式碼範例示範如何使用建構函式建立類別 SessionParameter 的預設實例 SessionParameter 。

// In this example, the session parameter "empid" is set
// after the employee successfully logs in.
SessionParameter empid = new SessionParameter();
empid.Name = "empid";
empid.Type = TypeCode.Int32;
empid.SessionField = "empid";

' In this example, the session parameter "empid" is set
' after the employee successfully logs in.
Dim empid As New SessionParameter()
empid.Name = "empid"
empid.Type = TypeCode.Int32
empid.SessionField = "empid"

備註

SessionParameter使用建構函式建立的 SessionParameter 物件會使用其所有屬性的預設值初始化。 SessionField 屬性會初始化為 String.Empty。此外， Name 屬性會初始化為 String.Empty 、 Type 屬性初始化為 TypeCode.Object 、 Direction 屬性初始化為 ParameterDirection.Input ，並將 DefaultValue 屬性初始化為 null 。

適用於

SessionParameter(SessionParameter)

使用 original 參數所指定的執行個體值，初始化 SessionParameter 類別的新執行個體。

protected:
 SessionParameter(System::Web::UI::WebControls::SessionParameter ^ original);

protected SessionParameter (System.Web.UI.WebControls.SessionParameter original);

new System.Web.UI.WebControls.SessionParameter : System.Web.UI.WebControls.SessionParameter -> System.Web.UI.WebControls.SessionParameter

Protected Sub New (original As SessionParameter)

參數

original: SessionParameter

SessionParameter，初始化目前執行個體的起源。

備註

建 SessionParameter(SessionParameter) 構函式是 Protected 用來複製實例的複製建 SessionParameter 構函式。物件的值 SessionParameter ，包括 SessionField 、 Name 和 Type 屬性，全都會傳送到新的實例。

另請參閱

Clone()

適用於

SessionParameter(String, String)

使用指定的字串識別要繫結的工作階段狀態名稱/值組，初始化 SessionParameter 類別的新具名執行個體。

public:
 SessionParameter(System::String ^ name, System::String ^ sessionField);

public SessionParameter (string name, string sessionField);

new System.Web.UI.WebControls.SessionParameter : string * string -> System.Web.UI.WebControls.SessionParameter

Public Sub New (name As String, sessionField As String)

參數

name: String

參數名稱。

sessionField: String

參數物件所繫結之 HttpSessionState 名稱/值組的名稱。預設為 Empty。

備註

Type和 Direction 屬性會以預設值初始化。

另請參閱

適用於

SessionParameter(String, DbType, String)

使用指定的名稱和型別，並且將參數繫結至指定的工作階段狀態名稱/值組，初始化 SessionParameter 類別的新執行個體。這是用於資料庫型別的建構函式。

public:
 SessionParameter(System::String ^ name, System::Data::DbType dbType, System::String ^ sessionField);

public SessionParameter (string name, System.Data.DbType dbType, string sessionField);

new System.Web.UI.WebControls.SessionParameter : string * System.Data.DbType * string -> System.Web.UI.WebControls.SessionParameter

Public Sub New (name As String, dbType As DbType, sessionField As String)

參數

name: String

參數名稱。

dbType: DbType

參數所代表的資料庫型別。

sessionField: String

參數物件所繫結之 HttpSessionState 名稱/值組的名稱。預設為 Empty。

備註

Direction和 ConvertEmptyStringToNull 屬性會以預設值初始化。

適用於

SessionParameter(String, TypeCode, String)

使用指定的字串識別要繫結的工作階段狀態名稱/值組，初始化 SessionParameter 類別的新具名且為強型別 (Strongly Typed) 的執行個體。

public:
 SessionParameter(System::String ^ name, TypeCode type, System::String ^ sessionField);

public SessionParameter (string name, TypeCode type, string sessionField);

new System.Web.UI.WebControls.SessionParameter : string * TypeCode * string -> System.Web.UI.WebControls.SessionParameter

Public Sub New (name As String, type As TypeCode, sessionField As String)

參數

name: String

參數名稱。

type: TypeCode

參數所代表的型別。預設為 Object。

sessionField: String

參數物件所繫結之 HttpSessionState 名稱/值組的名稱。預設為 Empty。

範例

下列程式碼範例示範如何使用 SessionParameter 建構函式來建立 SessionParameter 物件，並將其與控制項搭配 SqlDataSource 使用，以在控制項中 DataGrid 顯示資料。

<%@ Page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
private void Page_Load(object sender, System.EventArgs e)
{
    SqlDataSource OdbcToSql = new SqlDataSource();

    // Connect to SQL Server using an ODBC DSN.
    OdbcToSql.ProviderName= "System.Data.Odbc";
    OdbcToSql.ConnectionString = "dsn=MyOdbcDsn;";

    // Use an ODBC parameterized query syntax.
    OdbcToSql.SelectCommand = "SELECT EmployeeID FROM Employees " +
                              " WHERE Country = ? AND ReportsTo = ?";

    // The country parameter has no default value, so be sure to set
    // a Session variable named "country" to "UK" or "USA".
    SessionParameter country =
        new SessionParameter("country",TypeCode.String,"country");

    SessionParameter reportsTo =
        new SessionParameter("report",TypeCode.Int32,"report");
    reportsTo.DefaultValue = "2";

    OdbcToSql.SelectParameters.Add(country);
    OdbcToSql.SelectParameters.Add(reportsTo);

    // Add the DataSourceControl to the page's Controls collection.
    Page.Controls.Add(OdbcToSql);

    DataGrid1.DataSource = OdbcToSql;
    DataGrid1.DataBind();
}

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="Form1" method="post" runat="server">
            <asp:DataGrid
                id="DataGrid1"
                style="Z-INDEX: 101; LEFT: 56px; POSITION: absolute; TOP: 56px"
                runat="server" />
        </form>
    </body>
</html>

<%@ Page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
Private Sub Page_Load(sender As Object, e As EventArgs)

    Dim OdbcToSql As New SqlDataSource()

    ' Connect to SQL Server using an ODBC DSN.
    OdbcToSql.ProviderName= "System.Data.Odbc"
    OdbcToSql.ConnectionString = "dsn=MyOdbcDsn;"

    ' Use an ODBC parameterized query syntax.
    OdbcToSql.SelectCommand = "SELECT EmployeeID FROM Employees " & _
                              " WHERE Country = ? AND ReportsTo = ?"

    ' The country parameter has no default value, so be sure to set
    ' a Session variable named "country" to "UK" or "USA".
    Dim country As SessionParameter
    country = New SessionParameter("country",TypeCode.String,"country")

    Dim reportsTo As SessionParameter
    reportsTo = New SessionParameter("report",TypeCode.Int32,"report")
    reportsTo.DefaultValue = "2"

    OdbcToSql.SelectParameters.Add(country)
    OdbcToSql.SelectParameters.Add(reportsTo)

    ' Add the DataSourceControl to the page's Controls collection.
    Page.Controls.Add(OdbcToSql)

    DataGrid1.DataSource = OdbcToSql
    DataGrid1.DataBind()

End Sub ' Page_Load

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="Form1" method="post" runat="server">
      <asp:DataGrid
          id="DataGrid1"
          style="Z-INDEX: 101; LEFT: 56px; POSITION: absolute; TOP: 56px"
          runat="server" />
    </form>
  </body>
</html>

備註

Direction和 ConvertEmptyStringToNull 屬性會以預設值初始化。

另請參閱

適用於

共用方式為

SessionParameter 建構函式

定義

多載

SessionParameter()

範例

備註

適用於

SessionParameter(SessionParameter)

參數

備註

另請參閱

適用於

SessionParameter(String, String)

參數

備註

另請參閱

適用於

SessionParameter(String, DbType, String)

參數

備註

適用於

SessionParameter(String, TypeCode, String)

參數

範例

備註

另請參閱

適用於

其他資源