SessionParameter 建構函式

定義

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

組件:: System.Web.dll

重要

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

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

多載

名稱	Description
SessionParameter()	初始化一個新的無名類別實例 SessionParameter 。
SessionParameter(SessionParameter)	初始化類別的新實例 SessionParameter ，並以參數指定的 `original` 實例值。
SessionParameter(String, String)	初始化一個新的命名實例 SessionParameter ，使用指定的字串來識別要綁定哪一對會話狀態名稱/值對。
SessionParameter(String, DbType, String)	初始化類別的新實例 SessionParameter ，方法是使用指定的名稱與型態，並將參數綁定到指定的會話狀態名稱/值對。此建構器用於資料庫類型。
SessionParameter(String, TypeCode, String)	初始化一個新的命名且強型別的類別實例 SessionParameter ，使用指定的字串來識別要綁定哪對會話狀態名稱/值對。

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)

初始化類別的新實例 SessionParameter ，並以參數指定的 original 實例值。

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 ，使用指定的字串來識別要綁定哪對會話狀態名稱/值對。

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)

參數

範例

備註

另請參閱

適用於

意見反應