HttpCookieCollection Classe

Riferimento

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 trovano nella richiesta HTTP, vengono creati nella risposta HTTP. Se esistono i due cookie, 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

HttpCookieCollection()

Inizializza una nuova istanza della classe HttpCookieCollection.

Proprietà

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 della classe NameObjectCollectionBase. (Ereditato da NameObjectCollectionBase)
IsReadOnly	Ottiene o imposta un valore che indica se l'istanza di 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. (Ereditato da NameObjectCollectionBase)

Metodi

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 di NameObjectCollectionBase. (Ereditato da NameObjectCollectionBase)
BaseClear()	Rimuove tutte le voci dall'istanza di NameObjectCollectionBase. (Ereditato da NameObjectCollectionBase)
BaseGet(Int32)	Ottiene il valore della voce in corrispondenza dell'indice specificato dell'istanza di NameObjectCollectionBase. (Ereditato da NameObjectCollectionBase)
BaseGet(String)	Ottiene il valore della prima voce con la chiave specificata dall'istanza di NameObjectCollectionBase. (Ereditato da NameObjectCollectionBase)
BaseGetAllKeys()	Restituisce una matrice String che contiene tutte le chiavi incluse nell'istanza di NameObjectCollectionBase. (Ereditato da NameObjectCollectionBase)
BaseGetAllValues()	Restituisce una matrice Object che contiene tutti i valori inclusi nell'istanza di NameObjectCollectionBase. (Ereditato da NameObjectCollectionBase)
BaseGetAllValues(Type)	Restituisce una matrice del tipo specificato che contiene tutti i valori inclusi nell'istanza di NameObjectCollectionBase. (Ereditato da NameObjectCollectionBase)
BaseGetKey(Int32)	Ottiene la chiave della voce in corrispondenza dell'indice specificato dell'istanza di NameObjectCollectionBase. (Ereditato da NameObjectCollectionBase)
BaseHasKeys()	Ottiene un valore che indica se l'istanza di NameObjectCollectionBase contiene voci le cui chiavi non sono `null`. (Ereditato da NameObjectCollectionBase)
BaseRemove(String)	Rimuove le voci con la chiave specificata dall'istanza di NameObjectCollectionBase. (Ereditato da NameObjectCollectionBase)
BaseRemoveAt(Int32)	Rimuove la voce in corrispondenza dell'indice specificato dell'istanza di NameObjectCollectionBase. (Ereditato da NameObjectCollectionBase)
BaseSet(Int32, Object)	Imposta il valore della voce in corrispondenza dell'indice specificato dell'istanza di NameObjectCollectionBase. (Ereditato da NameObjectCollectionBase)
BaseSet(String, Object)	Imposta il valore della prima voce con la chiave specificata contenuta nell'istanza di NameObjectCollectionBase, se presente; in caso contrario aggiunge una voce con la chiave e il valore specificati nell'istanza di 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 elemento Array 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 esegue l'iterazione di 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 a serializzare l'istanza di NameObjectCollectionBase. (Ereditato da NameObjectCollectionBase)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnDeserialization(Object)	Implementa l'interfaccia ISerializable e genera l'evento di deserializzazione quando la deserializzazione è completa. (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

ICollection.CopyTo(Array, Int32)	Copia l'intero oggetto NameObjectCollectionBase in un oggetto Array compatibile unidimensionale, 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 usato per sincronizzare l'accesso all'oggetto NameObjectCollectionBase. (Ereditato da NameObjectCollectionBase)

Metodi di estensione

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

Si applica a

Vedi anche

HttpCookie