Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês
Esta documentação foi arquivada e não está sendo atualizada.

Classe CookieParameter

Vincula 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 parametrizada ou comando para selecionar, filtrar ou atualizar dados.

System.Object
  System.Web.UI.WebControls.Parameter
    System.Web.UI.WebControls.CookieParameter

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (em System.Web.dll)

public class CookieParameter : Parameter

O tipo CookieParameter expõe os membros a seguir.

  NomeDescrição
Método públicoCookieParameter()Inicializa uma nova instância sem nome da CookieParameter classe.
Método protegidoCookieParameter(CookieParameter)Inicializa uma nova instância da CookieParameter a classe com os valores da instância especificada pelo original parâmetro.
Método públicoCookieParameter(String, String)Inicializa uma nova instância de nomeada a CookieParameter classe usando a seqüência especificada para identificar qual cookie HTTP para vincular a.
Método públicoCookieParameter(String, DbType, String)Inicializa uma nova instância de CookieParameter classe que tem o tipo de banco de dados e o nome especificado e que está vinculado no cookie HTTP especificado.
Método públicoCookieParameter(String, TypeCode, String)Inicializa uma nova instância nomeada e com rigidez de tipos da CookieParameter classe usando a seqüência especificada para identificar qual cookie HTTP para vincular a.
Início

  NomeDescrição
Propriedade públicaConvertEmptyStringToNullObtém ou define um valor indicando se o valor que o Parameter objeto está vinculado ao devem ser convertidos em null se ele for String.Empty. (Herdado de Parameter.)
Propriedade públicaCookieNameObtém ou define o nome do cookie HTTP que vincula o parâmetro.
Propriedade públicaDbTypeObtém ou define o tipo de banco de dados do parâmetro. (Herdado de Parameter.)
Propriedade públicaDefaultValueEspecifica um valor padrão para o parâmetro de vinculado do valor do parâmetro deve ser inicializado quando o Evaluate método é chamado. (Herdado de Parameter.)
Propriedade públicaDirectionIndica se a Parameter objeto é usado para associar um valor de um controle ou o controle pode ser usado para alterar o valor. (Herdado de Parameter.)
Propriedade protegidaIsTrackingViewStateObtém um valor indicando se o Parameter objeto está salvando alterações em seu estado de exibição. (Herdado de Parameter.)
Propriedade públicaNameObtém ou define o nome do parâmetro. (Herdado de Parameter.)
Propriedade públicaSizeObtém ou define o tamanho do parâmetro. (Herdado de Parameter.)
Propriedade públicaTypeObtém ou define o tipo do parâmetro. (Herdado de Parameter.)
Propriedade protegidaViewStateObtém um dicionário de informações de estado que permite que você salvar e restaurar o estado de exibição de um Parameter objeto nas várias solicitações para a mesma página. (Herdado de Parameter.)
Início

  NomeDescrição
Método protegidoCloneRetorna uma duplicata do atual CookieParameter instância. (Substitui Parameter.Clone().)
Método públicoEquals(Object) Determina se o Object especificado é igual ao Object atual. (Herdado de Object.)
Método protegidoEvaluateAtualiza e retorna o valor de CookieParameter objeto. (Substitui Parameter.Evaluate(HttpContext, Control).)
Método protegidoFinalize Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)
Método públicoGetDatabaseTypeObtém o DbType valor que é equivalente ao tipo CLR do atual Parameter instância. (Herdado de Parameter.)
Método públicoGetHashCodeServe como uma função hash para um tipo específico. (Herdado de Object.)
Método públicoGetType Obtém o Type da instância atual. (Herdado de Object.)
Método protegidoLoadViewStateA exibição de fonte de dados anteriormente restaura o estado de exibição. (Herdado de Parameter.)
Método protegidoMemberwiseCloneCria uma cópia superficial do Object atual. (Herdado de Object.)
Método protegidoOnParameterChangedChamadas de OnParametersChanged método o ParameterCollection coleção que contém o Parameter objeto. (Herdado de Parameter.)
Método protegidoSaveViewStateSalva as alterações para o Parameter estado de exibição do objeto desde o momento em que a página foi postada de volta ao servidor. (Herdado de Parameter.)
Método protegidoSetDirtyMarcas de Parameter de objeto para seu estado será gravado no estado de exibição. (Herdado de Parameter.)
Método públicoToStringConverte o valor desta instância em sua representação de seqüência equivalente. (Herdado de Parameter.)
Método protegidoTrackViewStateFaz com que o Parameter o objeto para controlar alterações ao seu estado de exibição para que eles podem ser armazenados no controle de ViewState objeto persistente entre solicitações de e para a mesma página. (Herdado de Parameter.)
Início

  NomeDescrição
Implementação explícita da interfaceMétodo particularICloneable.CloneRetorna uma duplicata do atual Parameter instância. (Herdado de Parameter.)
Implementação explícita da interfacePropriedade particularIStateManager.IsTrackingViewStateInfraestrutura. Obtém um valor indicando se o Parameter objeto está salvando alterações em seu estado de exibição. (Herdado de Parameter.)
Implementação explícita da interfaceMétodo particularIStateManager.LoadViewStateInfraestrutura. A exibição de fonte de dados anteriormente restaura o estado de exibição. (Herdado de Parameter.)
Implementação explícita da interfaceMétodo particularIStateManager.SaveViewStateInfraestrutura. Salva as alterações para o Parameter estado de exibição do objeto desde o momento em que a página foi postada de volta ao servidor. (Herdado de Parameter.)
Implementação explícita da interfaceMétodo particularIStateManager.TrackViewStateInfraestrutura. Faz com que o Parameter o objeto para controlar alterações ao seu estado de exibição para que eles podem ser armazenados no controle de ViewState objeto persistente entre solicitações de e para a mesma página. (Herdado de Parameter.)
Início

Você pode usar o a classeCookieParameter para vincular o valor de um cookie HTTP do lado do cliente é passado como parte de uma solicitação HTTP para um parâmetro usado pelo ASP.Fonte de dados NET controles.

O CookieParameter classe fornece o CookieName propriedade, que identifica o nome da HttpCookie herdadas do objeto para vincular, junto da Parameter classe. O CookieParameter classe tenta vincular ao cookie nomeado sempre o Evaluate método é chamado.

Observação importanteImportante

Controles que ligar dados para o parâmetro podem lançar uma exceção se um CookieParameter objeto for especificado, mas nenhum cookie correspondente é passado com a solicitação HTTP. Da mesma forma, eles podem exibir sem dados se o cookie é passado com null. Definir o DefaultValue propriedade para evitar essas situações onde for apropriado.

O exemplo de código a seguir demonstra como usar um SqlDataSource controle e CookieParameter objeto vinculado a um cookie HTTP para exibir dados do banco de dados Northwind Traders em um GridView de 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>


.NET Framework

Com suporte em: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 ou posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core não compatível), Windows Server 2008 R2 (Server Core não compatível com SP1 ou posterior), Windows Server 2003 SP2

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos de sistema do .NET Framework.

Quaisquer membros static (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.
Mostrar: