SessionParameter.SessionField Eigenschaft

  • Referenz

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, mit der der HttpSessionState identifiziert wird, an den der Parameter gebunden wird.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie ein SessionParameter Objekt deklarativ erstellen, dessen SessionFieldNameEigenschaften und DefaultValue festlegen und es der SelectParameters Auflistung eines SqlDataSource Steuerelements hinzufügen. Ein GridView Steuerelement zeigt die Ergebnisse der vom Steuerelement übermittelten SqlDataSource 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, bindet das SessionParameter zur Laufzeit an den entsprechenden Wert. Wenn das erwartete Sitzungszeichenfolgennamen-Wert-Paar nicht in der Sitzung gefunden wird, bindet die Evaluate -Methode den Parameter an den Wert der DefaultValue -Eigenschaft, wenn er festgelegt ist. Wenn die DefaultValue -Eigenschaft nicht festgelegt ist, kann die Evaluate Methode den Parameter nicht an einen Wert binden.

Gilt für: