SessionParameter.SessionField Propiedad

Definición

Obtiene o establece el nombre de la variable de sesión a la que se enlaza el parámetro.Gets or sets the name of the session variable that the parameter binds to.

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

Valor de propiedad

Cadena que identifica el objeto HttpSessionState al que se enlaza el parámetro.A string that identifies the HttpSessionState that the parameter binds to.

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear mediante declaración un objeto SessionParameter, establecer su Name, SessionField y DefaultValue propiedades, y agregarlo a la colección SelectParameters de un control SqlDataSource.The following code example demonstrates how to declaratively create a SessionParameter object, set its Name, SessionField and DefaultValue properties, and add it to the SelectParameters collection of a SqlDataSource control. Un control GridView muestra los resultados de la consulta SQL enviada por el control SqlDataSource.A GridView control displays the results of the SQL query submitted by the SqlDataSource control.

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

En el ejemplo de código siguiente se muestra cómo establecer mediante programación la propiedad SessionField de un objeto SessionParameter.The following code example demonstrates how to programmatically set the SessionField property of a SessionParameter object.

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

Comentarios

La propiedad SessionField identifica un par de nombre y valor que se almacena en el objeto de sesión actual asociado al explorador Web.The SessionField property identifies a name/value pair that is stored in the current session object associated with the Web browser. Mientras que la propiedad SessionField identifica el nombre del par, el SessionParameter enlaza a su valor correspondiente en tiempo de ejecución.While the SessionField property identifies the name of the pair, the SessionParameter binds to its corresponding value at run time. Si el par de nombre y valor de la cadena de sesión esperada no se encuentra en la sesión, el método Evaluate enlaza el parámetro al valor de la propiedad DefaultValue, si está establecido.If the expected session string name/value pair is not found in the session, the Evaluate method binds the parameter to the value of the DefaultValue property, if it is set. Si no se establece la propiedad DefaultValue, el método Evaluate no puede enlazar el parámetro a un valor.If the DefaultValue property is not set, the Evaluate method fails to bind the parameter to a value.

Se aplica a