CookieParameter Classe

Definição

Espaço de Nomes:: System.Web.UI.WebControls

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Vincula o valor de um cookie HTTP do lado do cliente a um objeto de parâmetro. O parâmetro pode ser usado numa consulta ou comando parametrizado para selecionar, filtrar ou atualizar dados.

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

Herança: Object

Parameter
CookieParameter

Exemplos

O exemplo de código seguinte demonstra como usar um SqlDataSource controlo e CookieParameter um objeto vinculados a um cookie HTTP para mostrar dados da base de dados Northwind Traders num GridView controlo.

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

Observações

Pode usar a classe CookieParameter para vincular o valor de um cookie HTTP do lado do cliente passado como parte de um pedido HTTP a um parâmetro usado por ASP.NET controlos de fonte de dados.

A CookieParameter classe fornece a CookieName propriedade que identifica o nome do HttpCookie objeto a ligar, além dos herdados da Parameter classe. A CookieParameter classe tenta associar-se ao cookie nomeado sempre que o Evaluate método é chamado.

Importante

Controlos que associam dados ao parâmetro podem lançar uma exceção se um CookieParameter objeto for especificado, mas nenhum cookie correspondente for passado com o pedido HTTP. De forma semelhante, podem não mostrar dados se o cookie for passado com null. Defina a DefaultValue propriedade para evitar estas situações quando apropriado.

Construtores

Name	Description
CookieParameter()	Inicializa uma nova instância sem nome da CookieParameter classe.
CookieParameter(CookieParameter)	Inicializa uma nova instância da CookieParameter classe com os valores da instância especificados pelo `original` parâmetro.
CookieParameter(String, DbType, String)	Inicializa uma nova instância da CookieParameter classe que tem o nome e tipo de base de dados especificados e que está associada ao cookie HTTP especificado.
CookieParameter(String, String)	Inicializa uma nova instância nomeada da CookieParameter classe, usando a string especificada para identificar a que cookie HTTP deve ligar.
CookieParameter(String, TypeCode, String)	Inicializa uma nova instância nomeada e fortemente tipada da CookieParameter classe, usando a string especificada para identificar a que cookie HTTP deve ser associado.

Propriedades

Name	Description
ConvertEmptyStringToNull	Obtém ou define um valor que indica se o valor ao qual o Parameter objeto está ligado deve ser convertido se `null` for Empty. (Herdado de Parameter)
CookieName	Recebe ou define o nome do cookie HTTP ao qual o parâmetro se liga.
DbType	Obtém ou define o tipo de base de dados do parâmetro. (Herdado de Parameter)
DefaultValue	Especifica um valor por defeito para o parâmetro, caso o valor que o parâmetro está vinculado a ser não inicializado quando o Evaluate(HttpContext, Control) método for chamado. (Herdado de Parameter)
Direction	Indica se o Parameter objeto é usado para associar um valor a um controlo, ou se o controlo pode ser usado para alterar o valor. (Herdado de Parameter)
IsTrackingViewState	Recebe um valor que indica se o Parameter objeto está a guardar alterações ao seu estado de visualização. (Herdado de Parameter)
Name	Obtém ou define o nome do parâmetro. (Herdado de Parameter)
Size	Obtém ou define o tamanho do parâmetro. (Herdado de Parameter)
Type	Obtém ou define o tipo do parâmetro. (Herdado de Parameter)
ValidateInput	Recebe ou define um valor que especifica se o valor do parâmetro está validado.
ViewState	Obtém um dicionário de informação de estado que permite guardar e restaurar o estado de visualização de um Parameter objeto através de múltiplos pedidos para a mesma página. (Herdado de Parameter)

Métodos

Name	Description
Clone()	Devolve um duplicado da instância atual CookieParameter .
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
Evaluate(HttpContext, Control)	Atualiza e devolve o valor do CookieParameter objeto.
GetDatabaseType()	Obtém o DbType valor equivalente ao tipo CLR da instância atual Parameter . (Herdado de Parameter)
GetHashCode()	Serve como função de hash predefinida. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
LoadViewState(Object)	Restaura o estado da vista de fonte de dados anteriormente guardada. (Herdado de Parameter)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
OnParameterChanged()	Chama o OnParametersChanged(EventArgs) método da ParameterCollection coleção que contém o Parameter objeto. (Herdado de Parameter)
SaveViewState()	Guarda as alterações ao estado de Parameter visualização do objeto desde o momento em que a página foi publicada de volta no servidor. (Herdado de Parameter)
SetDirty()	Marca o Parameter objeto para que o seu estado fique registado no estado de visualização. (Herdado de Parameter)
ToString()	Converte o valor desta instância para a sua representação equivalente da cadeia. (Herdado de Parameter)
TrackViewState()	Faz com que o Parameter objeto acompanhe alterações ao seu estado de visualização para que possam ser armazenadas no objeto do ViewState controlo e persistidas entre pedidos para a mesma página. (Herdado de Parameter)

Implementações de Interface Explícita

Name	Description
ICloneable.Clone()	Devolve um duplicado da instância atual Parameter . (Herdado de Parameter)
IStateManager.IsTrackingViewState	Recebe um valor que indica se o Parameter objeto está a guardar alterações ao seu estado de visualização. (Herdado de Parameter)
IStateManager.LoadViewState(Object)	Restaura o estado da vista de fonte de dados anteriormente guardada. (Herdado de Parameter)
IStateManager.SaveViewState()	Guarda as alterações ao estado de Parameter visualização do objeto desde o momento em que a página foi publicada de volta no servidor. (Herdado de Parameter)
IStateManager.TrackViewState()	Faz com que o Parameter objeto acompanhe alterações ao seu estado de visualização para que possam ser armazenadas no objeto do ViewState controlo e persistidas entre pedidos para a mesma página. (Herdado de Parameter)

Aplica-se a

Ver também

Comentários

Esta página foi útil?