SessionParameter.SessionField Tulajdonság

Definíció

Névtér:
System.Web.UI.WebControls
Szerelvény:
System.Web.dll

Lekéri vagy beállítja annak a munkamenet-változónak a nevét, amelyhez a paraméter kapcsolódik.

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

Tulajdonság értéke

String

Egy sztring, amely azonosítja azt a HttpSessionState paramétert, amelyhez a paraméter kapcsolódik.

Példák

Az alábbi példakód bemutatja, hogyan hozhat létre deklaratív módon egy SessionParameter objektumot, állíthatja Namebe annak tulajdonságait SessionField és DefaultValue tulajdonságait, és hogyan adhat hozzá egy SelectParametersSqlDataSource vezérlő gyűjteményéhez. A GridView vezérlő megjeleníti a vezérlő által SqlDataSource küldött SQL-lekérdezés eredményeit.

<%@ 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>

Az alábbi példakód bemutatja, hogyan állíthatja be programozott módon egy SessionField objektum tulajdonságát 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"

Megjegyzések

A SessionField tulajdonság a webböngészőhöz társított aktuális munkamenet-objektumban tárolt név-érték párokat azonosítja. Bár a SessionField tulajdonság azonosítja a pár nevét, a futtatáskor a SessionParameter megfelelő értékhez kötődik. Ha a munkamenetben nem található a várt munkamenet-sztringnév/értékpár, a Evaluate metódus a paramétert a DefaultValue tulajdonság értékéhez köti, ha be van állítva. Ha a DefaultValue tulajdonság nincs beállítva, a Evaluate metódus nem köti a paramétert egy értékhez.

A következőre érvényes: