Freigeben über

SessionParameter.SessionField Eigenschaft

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ruft den Namen der Sitzungsvariablen ab, an die der Parameter gebunden ist, oder legt diesen fest.

public:
 property System::String ^ SessionField { System::String ^ get(); void set(System::String ^ value); };
public string SessionField { get; set; }
member this.SessionField : string with get, set
Public Property SessionField As String

Eigenschaftswert

String

Eine Zeichenfolge, die die Bindung des HttpSessionState Parameters angibt.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie ein SessionParameter Objekt deklarativ erstellen, dessen SessionFieldNameEigenschaften festlegen und DefaultValue der Auflistung eines SqlDataSource Steuerelements hinzufügenSelectParameters. Ein GridView Steuerelement zeigt die Ergebnisse der vom SqlDataSource Steuerelement übermittelten SQL-Abfrage an.

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

<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">
      <p>Show My Orders:</p>

      <asp:SqlDataSource
          id="OdbcDataSource1"
          runat="server"
          ProviderName="System.Data.Odbc"
          ConnectionString="dsn=MyOdbcDsn;"
          SelectCommand="SELECT OrderId, CustomerId, OrderDate
                         FROM Orders
                         WHERE EmployeeID = ?
                         ORDER BY CustomerId ASC;">
          <SelectParameters>
              <asp:SessionParameter
                Name="empid"
                SessionField="empid"
                DefaultValue="5" />
          </SelectParameters>
      </asp:SqlDataSource>

      <p>
      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="OdbcDataSource1" />
      </p>
    </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">

<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">
      <p>Show My Orders:</p>

      <asp:SqlDataSource
          id="OdbcDataSource1"
          runat="server"
          ProviderName="System.Data.Odbc"
          ConnectionString="dsn=MyOdbcDsn;"
          SelectCommand="SELECT OrderId, CustomerId, OrderDate 
                         FROM Orders 
                         WHERE EmployeeID = ? 
                         ORDER BY CustomerId ASC;">
          <SelectParameters>
              <asp:SessionParameter
                Name="empid"
                SessionField="empid"
                DefaultValue="5" />
          </SelectParameters>
      </asp:SqlDataSource>

      <p>
      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="OdbcDataSource1" />
      </p>
    </form>
  </body>
</html>

Im folgenden Codebeispiel wird veranschaulicht, wie die SessionField Eigenschaft eines SessionParameter Objekts programmgesteuert festgelegt wird.

// 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"

Hinweise

Die SessionField Eigenschaft identifiziert ein Name/Wert-Paar, das im aktuellen Sitzungsobjekt gespeichert ist, das dem Webbrowser zugeordnet ist. Während die SessionField Eigenschaft den Namen des Paares identifiziert, wird die SessionParameter Bindung an den entsprechenden Wert zur Laufzeit festgelegt. Wenn das erwartete Sitzungszeichenfolgennamen/Wertpaar in der Sitzung nicht gefunden wird, bindet die Evaluate Methode den Parameter an den Wert der DefaultValue Eigenschaft, wenn sie festgelegt ist. Wenn die Eigenschaft nicht festgelegt ist, kann die DefaultValueEvaluate Methode den Parameter nicht an einen Wert binden.

Gilt für: