CookieParameter 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 cookie HTTP del lado cliente a un objeto de parámetro. El parámetro se puede usar en una consulta o comando con parámetros 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 usado 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 proceda.

Constructores

Nombre	Description
CookieParameter()	Inicializa una nueva instancia sin nombre de la CookieParameter clase .
CookieParameter(CookieParameter)	Inicializa una nueva instancia de la CookieParameter clase con los valores de la instancia especificada por el `original` parámetro .
CookieParameter(String, DbType, String)	Inicializa una nueva instancia de la CookieParameter clase que tiene el nombre y el tipo de base de datos especificados y que está enlazado a la cookie HTTP especificada.
CookieParameter(String, String)	Inicializa una nueva instancia con nombre de la CookieParameter clase utilizando la cadena especificada para identificar a qué cookie HTTP se va a enlazar.
CookieParameter(String, TypeCode, String)	Inicializa una nueva instancia con nombre y fuertemente tipada de la CookieParameter clase utilizando la cadena especificada para identificar a qué cookie HTTP 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)
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 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)
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)
ValidateInput	Obtiene o establece un valor que especifica si se valida el valor del parámetro.
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 CookieParameter .
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
Evaluate(HttpContext, Control)	Actualiza y devuelve el valor del CookieParameter 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

CookieParameter Clase

Definición

Ejemplos

Comentarios

Constructores

Propiedades

Métodos

Implementaciones de interfaz explícitas

Se aplica a

Consulte también

Comentarios