HttpCookieCollection Classe

Definizione

Spazio dei nomi:: System.Web

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.

Fornisce un modo indipendente dai tipi per modificare i cookie HTTP.

public ref class HttpCookieCollection sealed : System::Collections::Specialized::NameObjectCollectionBase

public sealed class HttpCookieCollection : System.Collections.Specialized.NameObjectCollectionBase

type HttpCookieCollection = class
    inherit NameObjectCollectionBase

Public NotInheritable Class HttpCookieCollection
Inherits NameObjectCollectionBase

Ereditarietà: Object

NameObjectCollectionBase
HttpCookieCollection

Esempio

Nell'esempio di codice seguente viene illustrato come leggere i cookie usando la Cookies proprietà dell'oggetto HttpRequest e scrivere cookie usando la Cookies proprietà dell'oggetto HttpResponse . Entrambe le proprietà restituiscono HttpCookieCollection oggetti . Se uno dei due cookie denominati userName e lastVisit non si trova nella richiesta HTTP, questi vengono creati nella risposta HTTP. Se i due cookie esistono, vengono visualizzate le proprietà dei cookie.

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

    protected void Page_Load(object sender, EventArgs e)
    {
        StringBuilder sb = new StringBuilder();
        // Check to see if cookies exist in HTTP request.
        if (Request.Cookies["userName"] == null && 
            Request.Cookies["lastVist"] == null)
        {
            Response.Cookies["userName"].Value = "user name";
            Response.Cookies["userName"].Expires = DateTime.Now.AddMinutes(20d);

            HttpCookie aCookie = new HttpCookie("lastVisit");
            aCookie.Value = DateTime.Now.ToString();
            aCookie.Expires = DateTime.Now.AddMinutes(20d);
            Response.Cookies.Add(aCookie);
            sb.Append("Two cookies added to response. " + 
                "Refresh the page to read the cookies.");
        }
        else
        {
            HttpCookieCollection cookies = Request.Cookies;
            for (int i = 0; i < cookies.Count; i++)
            {
                sb.Append("Name: " + cookies[i].Name + "<br/>");
                sb.Append("Value: " + cookies[i].Value + "<br/>");
                sb.Append("Expires: " + cookies[i].Expires.ToString() +
                          "<br/><br/>");
            }
        }
        Label1.Text = sb.ToString();
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HttpCookieCollection Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:Label id="Label1" runat="server"></asp:Label>
    </div>
    </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">

    Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)

        Dim sb As New StringBuilder()
        ' Check to see if cookies exist in HTTP request.
        If (Request.Cookies("userName") Is Nothing AndAlso _
            Request.Cookies("lastVisit") Is Nothing) Then
            Response.Cookies("userName").Value = "user name"
            Response.Cookies("userName").Expires = DateTime.Now.AddMinutes(20D)

            Dim aCookie As HttpCookie
            aCookie = New HttpCookie("lastVisit")
            aCookie.Value = DateTime.Now.ToString()
            aCookie.Expires = DateTime.Now.AddMinutes(20D)
            Response.Cookies.Add(aCookie)
            sb.Append("Two cookies added to response. " & _
                "Refresh the page to read the cookies.")
        Else
            Dim cookies As HttpCookieCollection
            cookies = Request.Cookies
            For i As Integer = 0 To cookies.Count - 1
                sb.Append("Name: " & cookies(i).Name & "<br/>")
                sb.Append("Value: " & cookies(i).Value & "<br/>")
                sb.Append("Expires: " & cookies(i).Expires.ToString() & _
                          "<br/><br/>")
            Next

        End If
        Label1.Text = sb.ToString()
    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HttpCookieCollection Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:Label id="Label1" runat="server"></asp:Label>    
    </div>
    </form>
</body>
</html>

Costruttori

Nome	Descrizione
HttpCookieCollection()	Inizializza una nuova istanza della classe HttpCookieCollection.

Proprietà

Nome	Descrizione
AllKeys	Ottiene una matrice di stringhe contenente tutte le chiavi (nomi di cookie) nella raccolta di cookie.
Count	Ottiene il numero di coppie chiave/valore contenute nell'istanza NameObjectCollectionBase di . (Ereditato da NameObjectCollectionBase)
IsReadOnly	Ottiene o imposta un valore che indica se l'istanza NameObjectCollectionBase è di sola lettura. (Ereditato da NameObjectCollectionBase)
Item[Int32]	Ottiene il cookie con l'indice numerico specificato dalla raccolta di cookie.
Item[String]	Ottiene il cookie con il nome specificato dalla raccolta di cookie.
Keys	Ottiene un'istanza NameObjectCollectionBase.KeysCollection che contiene tutte le chiavi nell'istanza NameObjectCollectionBase di . (Ereditato da NameObjectCollectionBase)

Metodi

Nome	Descrizione
Add(HttpCookie)	Aggiunge il cookie specificato alla raccolta di cookie.
BaseAdd(String, Object)	Aggiunge una voce con la chiave e il valore specificati nell'istanza NameObjectCollectionBase di . (Ereditato da NameObjectCollectionBase)
BaseClear()	Rimuove tutte le voci dall'istanza NameObjectCollectionBase di . (Ereditato da NameObjectCollectionBase)
BaseGet(Int32)	Ottiene il valore della voce in corrispondenza dell'indice specificato dell'istanza NameObjectCollectionBase . (Ereditato da NameObjectCollectionBase)
BaseGet(String)	Ottiene il valore della prima voce con la chiave specificata dall'istanza NameObjectCollectionBase di . (Ereditato da NameObjectCollectionBase)
BaseGetAllKeys()	Restituisce una String matrice che contiene tutte le chiavi nell'istanza NameObjectCollectionBase di . (Ereditato da NameObjectCollectionBase)
BaseGetAllValues()	Restituisce una Object matrice che contiene tutti i valori nell'istanza NameObjectCollectionBase di . (Ereditato da NameObjectCollectionBase)
BaseGetAllValues(Type)	Restituisce una matrice del tipo specificato che contiene tutti i valori nell'istanza NameObjectCollectionBase di . (Ereditato da NameObjectCollectionBase)
BaseGetKey(Int32)	Ottiene la chiave della voce in corrispondenza dell'indice specificato dell'istanza NameObjectCollectionBase . (Ereditato da NameObjectCollectionBase)
BaseHasKeys()	Ottiene un valore che indica se l'istanza NameObjectCollectionBase contiene voci le cui chiavi non `null`sono . (Ereditato da NameObjectCollectionBase)
BaseRemove(String)	Rimuove le voci con la chiave specificata dall'istanza NameObjectCollectionBase di . (Ereditato da NameObjectCollectionBase)
BaseRemoveAt(Int32)	Rimuove la voce in corrispondenza dell'indice specificato dell'istanza NameObjectCollectionBase . (Ereditato da NameObjectCollectionBase)
BaseSet(Int32, Object)	Imposta il valore della voce in corrispondenza dell'indice specificato dell'istanza NameObjectCollectionBase . (Ereditato da NameObjectCollectionBase)
BaseSet(String, Object)	Imposta il valore della prima voce con la chiave specificata nell'istanza NameObjectCollectionBase , se presente; in caso contrario, aggiunge una voce con la chiave e il valore specificati nell'istanza NameObjectCollectionBase . (Ereditato da NameObjectCollectionBase)
Clear()	Cancella tutti i cookie dalla raccolta di cookie.
CopyTo(Array, Int32)	Copia i membri della raccolta di cookie in un Array oggetto a partire dall'indice specificato della matrice.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Get(Int32)	Restituisce l'elemento HttpCookie con l'indice specificato dalla raccolta di cookie.
Get(String)	Restituisce il cookie con il nome specificato dalla raccolta di cookie.
GetEnumerator()	Restituisce un enumeratore che scorre l'oggetto NameObjectCollectionBase. (Ereditato da NameObjectCollectionBase)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetKey(Int32)	Restituisce la chiave (nome) del cookie in corrispondenza dell'indice numerico specificato.
GetObjectData(SerializationInfo, StreamingContext)	Obsoleti. Implementa l'interfaccia ISerializable e restituisce i dati necessari per serializzare l'istanza NameObjectCollectionBase . (Ereditato da NameObjectCollectionBase)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
OnDeserialization(Object)	Implementa l'interfaccia ISerializable e genera l'evento di deserializzazione al termine della deserializzazione. (Ereditato da NameObjectCollectionBase)
Remove(String)	Rimuove il cookie con il nome specificato dalla raccolta.
Set(HttpCookie)	Aggiorna il valore di un cookie esistente in una raccolta di cookie.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
ICollection.CopyTo(Array, Int32)	Copia l'intero NameObjectCollectionBase oggetto in un oggetto unidimensionale Arraycompatibile, a partire dall'indice specificato della matrice di destinazione. (Ereditato da NameObjectCollectionBase)
ICollection.IsSynchronized	Ottiene un valore che indica se l'accesso all'oggetto NameObjectCollectionBase è sincronizzato (thread-safe). (Ereditato da NameObjectCollectionBase)
ICollection.SyncRoot	Ottiene un oggetto che può essere utilizzato per sincronizzare l'accesso all'oggetto NameObjectCollectionBase . (Ereditato da NameObjectCollectionBase)

Metodi di estensione

Nome	Descrizione
AsParallel(IEnumerable)	Abilita la parallelizzazione di una query.
AsQueryable(IEnumerable)	Converte un IEnumerable in un IQueryable.
Cast<TResult>(IEnumerable)	Esegue il cast degli elementi di un IEnumerable al tipo specificato.
OfType<TResult>(IEnumerable)	Filtra gli elementi di un IEnumerable in base a un tipo specificato.

Si applica a

Vedi anche

HttpCookie

Commenti e suggerimenti

Questa pagina è stata utile?