SessionParameter Clase

Referencia

Definición

Espacio de nombres:: System.Web.UI.WebControls

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Enlaza el valor de una variable de sesión a un objeto de parámetro.

public ref class SessionParameter : System::Web::UI::WebControls::Parameter

public class SessionParameter : System.Web.UI.WebControls.Parameter

type SessionParameter = class
    inherit Parameter

Public Class SessionParameter
Inherits Parameter

Herencia: Object

Parameter
SessionParameter

Ejemplos

En el ejemplo siguiente se muestra cómo usar un SessionParameter objeto . En el ejemplo se supone que otra página ha almacenado un valor de identificador de empleado en una variable de sesión denominada empid. En la página de ejemplo se usa la empid variable de sesión en la Where cláusula de una consulta y se muestra el resultado de la consulta en un GridView control . Dado que la DefaultValue propiedad del SessionParameter objeto se establece en 5, los datos del registro que tiene el employeeID valor 5 se seguirán mostrando si no se establece ninguna variable de sesión denominada empid antes de ejecutar el ejemplo.

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

Comentarios

Normalmente se usa un SessionParameter objeto para incluir el valor de una HttpSessionState variable en la Where cláusula de una consulta de base de datos. La SessionField propiedad identifica la variable de sesión de la SessionParameter que recupera un valor.

Nota

Los controles que enlazan datos a un parámetro mediante un SessionParameter objeto pueden producir una excepción si no se establece la variable de sesión especificada. Para evitar este error (si procede), establezca la DefaultValue propiedad .

Constructores

SessionParameter()	Inicializa una nueva instancia sin nombre de la clase SessionParameter.
SessionParameter(SessionParameter)	Inicializa una nueva instancia de la clase SessionParameter con los valores de la instancia que especifica el parámetro `original`.
SessionParameter(String, DbType, String)	Inicializa una nueva instancia de la clase SessionParameter con el nombre y el tipo especificados y enlazando el parámetro al par de nombre y valor del estado de sesión especificado. Este constructor es para tipos de base de datos.
SessionParameter(String, String)	Inicializa una nueva instancia con nombre de la clase SessionParameter, utilizando la cadena especificada para identificar el par de nombre y valor del estado de sesión con el que se realiza el enlace.
SessionParameter(String, TypeCode, String)	Inicializa una nueva instancia con nombre y fuertemente tipada de la clase SessionParameter, utilizando la cadena especificada para identificar con qué par de nombre y valor de estado de sesión se realiza el enlace.

Propiedades

ConvertEmptyStringToNull	Obtiene o establece un valor que indica si el valor al que está enlazado el objeto Parameter debe convertirse a `null` si es Empty. (Heredado de Parameter)
DbType	Obtiene o establece el tipo de base de datos del parámetro. (Heredado de Parameter)
DefaultValue	Especifica un valor predeterminado para el parámetro, si el valor al que está enlazado el parámetro no debe estar inicializado cuando se llame al método Evaluate(HttpContext, Control). (Heredado de Parameter)
Direction	Indica si el objeto Parameter se utiliza para enlazar un valor a un control o si se puede utilizar el control para cambiar el valor. (Heredado de Parameter)
IsTrackingViewState	Obtiene un valor que indica si el objeto Parameter está guardando los cambios en su estado de vista. (Heredado de Parameter)
Name	Obtiene o establece el nombre del parámetro. (Heredado de Parameter)
SessionField	Obtiene o establece el nombre de la variable de sesión a la que se enlaza el parámetro.
Size	Obtiene o establece el tamaño del parámetro. (Heredado de Parameter)
Type	Obtiene o establece el tipo de parámetro. (Heredado de Parameter)
ViewState	Obtiene un diccionario con información de estado que permite guardar y restaurar el estado de vista de un objeto Parameter en las distintas solicitudes de la misma página. (Heredado de Parameter)

Métodos

Clone()	Devuelve un duplicado de la instancia SessionParameter actual.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
Evaluate(HttpContext, Control)	Actualiza y devuelve el valor del objeto SessionParameter.
GetDatabaseType()	Obtiene el valor DbType que es equivalente al tipo CLR de la instancia Parameter actual. (Heredado de Parameter)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
LoadViewState(Object)	Restaura la vista del origen de datos tal y como se guardó previamente. (Heredado de Parameter)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnParameterChanged()	Llama al método OnParametersChanged(EventArgs) de la colección ParameterCollection que contiene el objeto Parameter. (Heredado de Parameter)
SaveViewState()	Guarda los cambios realizados en el estado de la vista del objeto Parameter desde el momento en que se devolvió la página al servidor. (Heredado de Parameter)
SetDirty()	Marca el objeto Parameter para que su estado se registre en el estado de vista. (Heredado de Parameter)
ToString()	Convierte el valor de esta instancia en la representación de cadena equivalente. (Heredado de Parameter)
TrackViewState()	Hace que el objeto Parameter realice el seguimiento de los cambios en su estado de vista, de modo que puedan almacenarse en el objeto ViewState del control y mantenerse en todas las solicitudes de la misma página. (Heredado de Parameter)

Implementaciones de interfaz explícitas

ICloneable.Clone()	Devuelve un duplicado de la instancia Parameter actual. (Heredado de Parameter)
IStateManager.IsTrackingViewState	Obtiene un valor que indica si el objeto Parameter está guardando los cambios en su estado de vista. (Heredado de Parameter)
IStateManager.LoadViewState(Object)	Restaura la vista del origen de datos tal y como se guardó previamente. (Heredado de Parameter)
IStateManager.SaveViewState()	Guarda los cambios realizados en el estado de la vista del objeto Parameter desde el momento en que se devolvió la página al servidor. (Heredado de Parameter)
IStateManager.TrackViewState()	Hace que el objeto Parameter realice el seguimiento de los cambios en su estado de vista, de modo que puedan almacenarse en el objeto ViewState del control y mantenerse en todas las solicitudes de la misma página. (Heredado de Parameter)

Se aplica a

Compartir vía