SessionParameter Clase

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

Nombre	Description
SessionParameter()	Inicializa una nueva instancia sin nombre de la SessionParameter clase .
SessionParameter(SessionParameter)	Inicializa una nueva instancia de la SessionParameter clase con los valores de la instancia especificada por el `original` parámetro .
SessionParameter(String, DbType, String)	Inicializa una nueva instancia de la SessionParameter clase, mediante el nombre y el tipo especificados, y enlaza el parámetro al par de nombre y valor de estado de sesión especificado. Este constructor es para los tipos de base de datos.
SessionParameter(String, String)	Inicializa una nueva instancia con nombre de la SessionParameter clase utilizando la cadena especificada para identificar a qué par de nombre y valor de estado de sesión se va a enlazar.
SessionParameter(String, TypeCode, String)	Inicializa una nueva instancia con nombre y fuertemente tipada de la SessionParameter clase, utilizando la cadena especificada para identificar a qué par nombre y valor de estado de sesión se va a enlazar.

Propiedades

Nombre	Description
ConvertEmptyStringToNull	Obtiene o establece un valor que indica si el valor al que está enlazado el Parameter objeto se debe convertir `null` en 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 del parámetro está enlazado a no inicializarse cuando se llama al Evaluate(HttpContext, Control) método . (Heredado de Parameter)
Direction	Indica si el Parameter objeto se usa para enlazar un valor a un control o el control se puede usar para cambiar el valor. (Heredado de Parameter)
IsTrackingViewState	Obtiene un valor que indica si el Parameter objeto guarda 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 del parámetro . (Heredado de Parameter)
ViewState	Obtiene un diccionario de información de estado que permite guardar y restaurar el estado de vista de un Parameter objeto en varias solicitudes para la misma página. (Heredado de Parameter)

Métodos

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

Implementaciones de interfaz explícitas

Nombre	Description
ICloneable.Clone()	Devuelve un duplicado de la instancia actual Parameter . (Heredado de Parameter)
IStateManager.IsTrackingViewState	Obtiene un valor que indica si el Parameter objeto guarda los cambios en su estado de vista. (Heredado de Parameter)
IStateManager.LoadViewState(Object)	Restaura el estado de vista guardado previamente de la vista del origen de datos. (Heredado de Parameter)
IStateManager.SaveViewState()	Guarda los cambios en el Parameter estado de vista del objeto desde el momento en que se devolvió la página al servidor. (Heredado de Parameter)
IStateManager.TrackViewState()	Hace que el Parameter objeto realice un seguimiento de los cambios en su estado de vista para que se puedan almacenar en el objeto del ViewState control y conservarse en las solicitudes de la misma página. (Heredado de Parameter)

Se aplica a

Consulte también

Comentarios

Resultoulle útil esta páxina?

Compartir por

SessionParameter Clase

Definición

Ejemplos

Comentarios

Constructores

Propiedades

Métodos

Implementaciones de interfaz explícitas

Se aplica a

Consulte también

Comentarios