Partilhar via

CookieParameter Classe

Definição

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Associa o valor de um cookie HTTP do lado do cliente a um objeto de parâmetro. O parâmetro pode ser usado em uma 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 a seguir demonstra como usar um controle e CookieParameter um SqlDataSource objeto associados a um cookie HTTP para exibir dados do banco de dados Northwind Traders em um GridView controle.

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

Comentários

Você pode usar a CookieParameter classe para associar o valor de um cookie HTTP do lado do cliente passado como parte de uma solicitação HTTP a um parâmetro usado por ASP.NET controles de fonte de dados.

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

Importante

Controles que associam dados ao parâmetro podem gerar uma exceção se um CookieParameter objeto for especificado, mas nenhum cookie correspondente é passado com a solicitação HTTP. Da mesma forma, eles podem não exibir dados se o cookie for passado com null. Defina a DefaultValue propriedade para evitar essas situações quando apropriado.

Construtores

Nome 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 o tipo de banco 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 cadeia de caracteres especificada para identificar a qual cookie HTTP será associado.
CookieParameter(String, TypeCode, String)

Inicializa uma nova instância nomeada e fortemente tipada da classe, usando a CookieParameter cadeia de caracteres especificada para identificar a qual cookie HTTP associar.

Propriedades

Nome Description
ConvertEmptyStringToNull

Obtém ou define um valor que indica se o valor ao qual o Parameter objeto está associado deve ser convertido null se for Empty.

(Herdado de Parameter)
CookieName

Obtém ou define o nome do cookie HTTP ao qual o parâmetro se associa.
DbType

Obtém ou define o tipo de banco de dados do parâmetro.

(Herdado de Parameter)
DefaultValue

Especifica um valor padrão para o parâmetro, caso o valor que o parâmetro esteja associado seja 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 controle ou se o controle pode ser usado para alterar o valor.

(Herdado de Parameter)
IsTrackingViewState

Obtém um valor que indica se o Parameter objeto está salvando alterações em seu estado de exibiçã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

Obtém ou define um valor que especifica se o valor do parâmetro é validado.
ViewState

Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um Parameter objeto em várias solicitações para a mesma página.

(Herdado de Parameter)

Métodos

Nome Description
Clone()

Retorna uma duplicata da instância atual CookieParameter .
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
Evaluate(HttpContext, Control)

Atualiza e retorna 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 a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
LoadViewState(Object)

Restaura o estado de exibição salvo anteriormente da exibição da fonte de dados.

(Herdado de Parameter)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
OnParameterChanged()

Chama o OnParametersChanged(EventArgs) método da ParameterCollection coleção que contém o Parameter objeto.

(Herdado de Parameter)
SaveViewState()

Salva as alterações no Parameter estado de exibição do objeto desde o momento em que a página foi postada novamente no servidor.

(Herdado de Parameter)
SetDirty()

Marca o Parameter objeto para que seu estado seja registrado no estado de exibição.

(Herdado de Parameter)
ToString()

Converte o valor dessa instância em sua representação de cadeia de caracteres equivalente.

(Herdado de Parameter)
TrackViewState()

Faz com que o Parameter objeto acompanhe as alterações em seu estado de exibição para que elas possam ser armazenadas no objeto do ViewState controle e mantidas entre solicitações para a mesma página.

(Herdado de Parameter)

Implantações explícitas de interface

Nome Description
ICloneable.Clone()

Retorna uma duplicata da instância atual Parameter .

(Herdado de Parameter)
IStateManager.IsTrackingViewState

Obtém um valor que indica se o Parameter objeto está salvando alterações em seu estado de exibição.

(Herdado de Parameter)
IStateManager.LoadViewState(Object)

Restaura o estado de exibição salvo anteriormente da exibição da fonte de dados.

(Herdado de Parameter)
IStateManager.SaveViewState()

Salva as alterações no Parameter estado de exibição do objeto desde o momento em que a página foi postada novamente no servidor.

(Herdado de Parameter)
IStateManager.TrackViewState()

Faz com que o Parameter objeto acompanhe as alterações em seu estado de exibição para que elas possam ser armazenadas no objeto do ViewState controle e mantidas entre solicitações para a mesma página.

(Herdado de Parameter)

Aplica-se a

Confira também