CookieParameter 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 cookie HTTP del lado cliente a un objeto de parámetro. El parámetro puede usarse en una consulta o parámetro parametrizados para seleccionar, filtrar o actualizar datos.

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

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

type CookieParameter = class
    inherit Parameter

Public Class CookieParameter
Inherits Parameter

Herencia: Object

Parameter
CookieParameter

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar un control y CookieParameter un SqlDataSource objeto enlazados a una cookie HTTP para mostrar datos de la base de datos northwind Traders en un GridView control .

<%@Page  Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

void Page_Load(Object sender, EventArgs e){
  // These cookies might be added by a login form.
  // They are added here for simplicity.
  if (!IsPostBack) {
      Response.Cookies.Add(new HttpCookie("lname",    "davolio"));
      Response.Cookies.Add(new HttpCookie("loginname","ndavolio"));
      Response.Cookies.Add(new HttpCookie("lastvisit", DateTime.Now.ToString()));
  }
}


</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataSet"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand = "SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate 
                           FROM Orders WHERE EmployeeID = 
                           (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
          <SelectParameters>
            <asp:CookieParameter Name="lastname" CookieName="lname" />
          </SelectParameters>
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          AllowSorting="True"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

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

<script runat="server">

Sub Page_Load(sender As Object, e As EventArgs)
  ' These cookies might be added by a login form.
  ' They are added here for simplicity.
  If (Not IsPostBack) Then
      Dim cookie As HttpCookie

      cookie = New HttpCookie("lname","davolio")
      Response.Cookies.Add(cookie)

      cookie = New HttpCookie("loginname","ndavolio")
      Response.Cookies.Add(cookie)

      cookie = New HttpCookie("lastvisit", DateTime.Now.ToString())
      Response.Cookies.Add(cookie)
  End If
End Sub ' Page_Load
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataSet"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand = "SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate 
                           FROM Orders WHERE EmployeeID = 
                           (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
          <SelectParameters>                 
            <asp:CookieParameter Name="lastname" CookieName="lname" />
          </SelectParameters>
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          AllowSorting="True"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

Comentarios

Puede usar la CookieParameter clase para enlazar el valor de una cookie HTTP del lado cliente que se pasa como parte de una solicitud HTTP a un parámetro utilizado por ASP.NET controles de origen de datos.

La CookieParameter clase proporciona la CookieName propiedad , que identifica el nombre del HttpCookie objeto al que se va a enlazar, además de los heredados de la Parameter clase . La CookieParameter clase intenta enlazar a la cookie con nombre cada vez que se llama al Evaluate método .

Importante

Los controles que enlazan datos al parámetro pueden producir una excepción si se especifica un CookieParameter objeto, pero no se pasa ninguna cookie correspondiente con la solicitud HTTP. Del mismo modo, es posible que no muestren datos si la cookie se pasa con null. Establezca la DefaultValue propiedad para evitar estas situaciones cuando corresponda.

Constructores

CookieParameter()	Inicializa una nueva instancia sin nombre de la clase CookieParameter.
CookieParameter(CookieParameter)	Inicializa una nueva instancia de la clase CookieParameter con los valores de la instancia que especifica el parámetro `original`.
CookieParameter(String, DbType, String)	Inicializa una nueva instancia de la clase CookieParameter que tiene el nombre y el tipo de base de datos especificados y que está enlazada a la cookie HTTP especificada.
CookieParameter(String, String)	Inicializa una nueva instancia con nombre de la clase CookieParameter, utilizando la cadena especificada para identificar a qué cookie HTTP se va a enlazar.
CookieParameter(String, TypeCode, String)	Inicializa una nueva instancia fuertemente tipada de la clase CookieParameter, utilizando la cadena especificada para identificar a qué cookie HTTP se va a enlazar.

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)
CookieName	Obtiene o establece el nombre de la cookie HTTP a la que se enlaza el parámetro.
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)
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)
ValidateInput	Obtiene o establece un valor que especifica si se valida el valor del parámetro.
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 CookieParameter 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 CookieParameter.
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 a través de