CookieParameter Classe

Definizione

Spazio dei nomi:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Associa il valore di un cookie HTTP sul lato client a un oggetto parametro. Il parametro può essere usato in una query o in un comando con parametri per selezionare, filtrare o aggiornare i dati.

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

Ereditarietà: Object

Parameter
CookieParameter

Esempio

Nell'esempio di codice seguente viene illustrato come usare un controllo e CookieParameter un SqlDataSource oggetto associato a un cookie HTTP per visualizzare i dati dal database Northwind Traders in un GridView controllo .

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

Commenti

È possibile usare la CookieParameter classe per associare il valore di un cookie HTTP sul lato client passato come parte di una richiesta HTTP a un parametro usato da ASP.NET controlli origine dati.

La CookieParameter classe fornisce la CookieName proprietà , che identifica il nome dell'oggetto a cui eseguire l'associazione HttpCookie , oltre a quelli ereditati dalla Parameter classe . La CookieParameter classe tenta di eseguire l'associazione al cookie denominato ogni volta che viene chiamato il Evaluate metodo .

Importante

I controlli che associano dati al parametro possono generare un'eccezione se viene specificato un CookieParameter oggetto , ma non viene passato alcun cookie corrispondente con la richiesta HTTP. Analogamente, potrebbero non visualizzare dati se il cookie viene passato con null. Impostare la DefaultValue proprietà per evitare queste situazioni, se appropriato.

Costruttori

Nome	Descrizione
CookieParameter()	Inizializza una nuova istanza senza nome della CookieParameter classe .
CookieParameter(CookieParameter)	Inizializza una nuova istanza della CookieParameter classe con i valori dell'istanza specificata dal `original` parametro .
CookieParameter(String, DbType, String)	Inizializza una nuova istanza della CookieParameter classe con il nome e il tipo di database specificati e associato al cookie HTTP specificato.
CookieParameter(String, String)	Inizializza una nuova istanza denominata della CookieParameter classe utilizzando la stringa specificata per identificare il cookie HTTP a cui eseguire l'associazione.
CookieParameter(String, TypeCode, String)	Inizializza una nuova istanza denominata e fortemente tipizzata della CookieParameter classe utilizzando la stringa specificata per identificare il cookie HTTP a cui eseguire l'associazione.

Proprietà

Nome	Descrizione
ConvertEmptyStringToNull	Ottiene o imposta un valore che indica se il valore a cui è associato l'oggetto Parameter deve essere convertito `null` in se è Empty. (Ereditato da Parameter)
CookieName	Ottiene o imposta il nome del cookie HTTP a cui il parametro è associato.
DbType	Ottiene o imposta il tipo di database del parametro . (Ereditato da Parameter)
DefaultValue	Specifica un valore predefinito per il parametro , se il valore associato al parametro deve essere non inizializzato quando viene chiamato il Evaluate(HttpContext, Control) metodo . (Ereditato da Parameter)
Direction	Indica se l'oggetto Parameter viene utilizzato per associare un valore a un controllo o se il controllo può essere utilizzato per modificare il valore. (Ereditato da Parameter)
IsTrackingViewState	Ottiene un valore che indica se l'oggetto Parameter sta salvando le modifiche apportate allo stato di visualizzazione. (Ereditato da Parameter)
Name	Ottiene o imposta il nome del parametro. (Ereditato da Parameter)
Size	Ottiene o imposta le dimensioni del parametro. (Ereditato da Parameter)
Type	Ottiene o imposta il tipo del parametro. (Ereditato da Parameter)
ValidateInput	Ottiene o imposta un valore che specifica se il valore del parametro viene convalidato.
ViewState	Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un Parameter oggetto in più richieste per la stessa pagina. (Ereditato da Parameter)

Metodi

Nome	Descrizione
Clone()	Restituisce un duplicato dell'istanza corrente CookieParameter .
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Evaluate(HttpContext, Control)	Aggiorna e restituisce il valore dell'oggetto CookieParameter .
GetDatabaseType()	Ottiene il DbType valore equivalente al tipo CLR dell'istanza corrente Parameter . (Ereditato da Parameter)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
LoadViewState(Object)	Ripristina lo stato di visualizzazione salvata in precedenza della vista origine dati. (Ereditato da Parameter)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
OnParameterChanged()	Chiama il OnParametersChanged(EventArgs) metodo dell'insieme ParameterCollection che contiene l'oggetto Parameter . (Ereditato da Parameter)
SaveViewState()	Salva le modifiche apportate allo Parameter stato di visualizzazione dell'oggetto dal momento in cui la pagina è stata pubblicata nel server. (Ereditato da Parameter)
SetDirty()	Contrassegna l'oggetto Parameter in modo che il relativo stato venga registrato nello stato di visualizzazione. (Ereditato da Parameter)
ToString()	Converte il valore di questa istanza nella rappresentazione di stringa equivalente. (Ereditato da Parameter)
TrackViewState()	Fa in modo che l'oggetto Parameter possa tenere traccia delle modifiche apportate allo stato di visualizzazione in modo che possano essere archiviate nell'oggetto del ViewState controllo e mantenute tra le richieste per la stessa pagina. (Ereditato da Parameter)

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
ICloneable.Clone()	Restituisce un duplicato dell'istanza corrente Parameter . (Ereditato da Parameter)
IStateManager.IsTrackingViewState	Ottiene un valore che indica se l'oggetto Parameter sta salvando le modifiche apportate allo stato di visualizzazione. (Ereditato da Parameter)
IStateManager.LoadViewState(Object)	Ripristina lo stato di visualizzazione salvata in precedenza della vista origine dati. (Ereditato da Parameter)
IStateManager.SaveViewState()	Salva le modifiche apportate allo Parameter stato di visualizzazione dell'oggetto dal momento in cui la pagina è stata pubblicata nel server. (Ereditato da Parameter)
IStateManager.TrackViewState()	Fa in modo che l'oggetto Parameter possa tenere traccia delle modifiche apportate allo stato di visualizzazione in modo che possano essere archiviate nell'oggetto del ViewState controllo e mantenute tra le richieste per la stessa pagina. (Ereditato da Parameter)

Si applica a

Vedi anche

Commenti e suggerimenti

Questa pagina è stata utile?