HttpCookieCollection Classe

Definizione

Fornisce un modo indipendente dai tipi per modificare i cookie HTTP.Provides a type-safe way to manipulate HTTP cookies.

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à
HttpCookieCollection

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come leggere Cookies i cookie utilizzando HttpRequest la proprietà dell'oggetto e scrivere Cookies i cookie HttpResponse utilizzando la proprietà dell'oggetto.The following code example demonstrates how to read cookies using the Cookies property of the HttpRequest object and write cookies using the Cookies property of the HttpResponse object. Entrambe le proprietà HttpCookieCollection restituiscono oggetti.Both properties return HttpCookieCollection objects. Se uno dei due cookie denominati userName e lastVisit non sono presenti nella richiesta HTTP, vengono creati nella risposta http.If either of two cookies named userName and lastVisit are not in the HTTP request, then they are created in the HTTP response. Se sono presenti due cookie, verranno visualizzate le proprietà dei cookie.If the two cookies exist, the properties of the cookies are displayed.

<%@ 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.Initializes a new instance of the HttpCookieCollection class.

Proprietà

AllKeys

Ottiene una matrice di stringhe contenente tutte le chiavi (nomi di cookie) nella raccolta di cookie.Gets a string array containing all the keys (cookie names) in the cookie collection.

Count

Ottiene il numero di coppie chiave/valore contenute nell'istanza della classe NameObjectCollectionBase.Gets the number of key/value pairs contained in the NameObjectCollectionBase instance.

(Ereditato da NameObjectCollectionBase)
IsReadOnly

Ottiene o imposta un valore che indica se l'istanza di NameObjectCollectionBase è di sola lettura.Gets or sets a value indicating whether the NameObjectCollectionBase instance is read-only.

(Ereditato da NameObjectCollectionBase)
Item[Int32]

Ottiene il cookie con l'indice numerico specificato dalla raccolta di cookie.Gets the cookie with the specified numerical index from the cookie collection.

Item[String]

Ottiene il cookie con il nome specificato dalla raccolta di cookie.Gets the cookie with the specified name from the cookie collection.

Keys

Ottiene un'istanza di NameObjectCollectionBase.KeysCollection che contiene tutte le chiavi incluse nell'istanza di NameObjectCollectionBase.Gets a NameObjectCollectionBase.KeysCollection instance that contains all the keys in the NameObjectCollectionBase instance.

(Ereditato da NameObjectCollectionBase)

Metodi

Add(HttpCookie)

Aggiunge il cookie specificato alla raccolta di cookie.Adds the specified cookie to the cookie collection.

BaseAdd(String, Object)

Aggiunge una voce con la chiave e il valore specificati nell'istanza di NameObjectCollectionBase.Adds an entry with the specified key and value into the NameObjectCollectionBase instance.

(Ereditato da NameObjectCollectionBase)
BaseClear()

Rimuove tutte le voci dall'istanza di NameObjectCollectionBase.Removes all entries from the NameObjectCollectionBase instance.

(Ereditato da NameObjectCollectionBase)
BaseGet(Int32)

Ottiene il valore della voce in corrispondenza dell'indice specificato dell'istanza di NameObjectCollectionBase.Gets the value of the entry at the specified index of the NameObjectCollectionBase instance.

(Ereditato da NameObjectCollectionBase)
BaseGet(String)

Ottiene il valore della prima voce con la chiave specificata dall'istanza di NameObjectCollectionBase.Gets the value of the first entry with the specified key from the NameObjectCollectionBase instance.

(Ereditato da NameObjectCollectionBase)
BaseGetAllKeys()

Restituisce una matrice String che contiene tutte le chiavi incluse nell'istanza di NameObjectCollectionBase.Returns a String array that contains all the keys in the NameObjectCollectionBase instance.

(Ereditato da NameObjectCollectionBase)
BaseGetAllValues()

Restituisce una matrice Object che contiene tutti i valori inclusi nell'istanza di NameObjectCollectionBase.Returns an Object array that contains all the values in the NameObjectCollectionBase instance.

(Ereditato da NameObjectCollectionBase)
BaseGetAllValues(Type)

Restituisce una matrice del tipo specificato che contiene tutti i valori inclusi nell'istanza di NameObjectCollectionBase.Returns an array of the specified type that contains all the values in the NameObjectCollectionBase instance.

(Ereditato da NameObjectCollectionBase)
BaseGetKey(Int32)

Ottiene la chiave della voce in corrispondenza dell'indice specificato dell'istanza di NameObjectCollectionBase.Gets the key of the entry at the specified index of the NameObjectCollectionBase instance.

(Ereditato da NameObjectCollectionBase)
BaseHasKeys()

Ottiene un valore che indica se l'istanza di NameObjectCollectionBase contiene voci le cui chiavi non sono null.Gets a value indicating whether the NameObjectCollectionBase instance contains entries whose keys are not null.

(Ereditato da NameObjectCollectionBase)
BaseRemove(String)

Rimuove le voci con la chiave specificata dall'istanza di NameObjectCollectionBase.Removes the entries with the specified key from the NameObjectCollectionBase instance.

(Ereditato da NameObjectCollectionBase)
BaseRemoveAt(Int32)

Rimuove la voce in corrispondenza dell'indice specificato dell'istanza di NameObjectCollectionBase.Removes the entry at the specified index of the NameObjectCollectionBase instance.

(Ereditato da NameObjectCollectionBase)
BaseSet(Int32, Object)

Imposta il valore della voce in corrispondenza dell'indice specificato dell'istanza di NameObjectCollectionBase.Sets the value of the entry at the specified index of the NameObjectCollectionBase instance.

(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.Sets the value of the first entry with the specified key in the NameObjectCollectionBase instance, if found; otherwise, adds an entry with the specified key and value into the NameObjectCollectionBase instance.

(Ereditato da NameObjectCollectionBase)
Clear()

Cancella tutti i cookie dalla raccolta di cookie.Clears all cookies from the cookie collection.

CopyTo(Array, Int32)

Copia i membri della raccolta di cookie in un elemento Array a partire dall'indice specificato della matrice.Copies members of the cookie collection to an Array beginning at the specified index of the array.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
Get(Int32)

Restituisce l'elemento HttpCookie con l'indice specificato dalla raccolta di cookie.Returns the HttpCookie item with the specified index from the cookie collection.

Get(String)

Restituisce il cookie con il nome specificato dalla raccolta di cookie.Returns the cookie with the specified name from the cookie collection.

GetEnumerator()

Restituisce un enumeratore che esegue l'iterazione di NameObjectCollectionBase.Returns an enumerator that iterates through the NameObjectCollectionBase.

(Ereditato da NameObjectCollectionBase)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetKey(Int32)

Restituisce la chiave (nome) del cookie in corrispondenza dell'indice numerico specificato.Returns the key (name) of the cookie at the specified numerical index.

GetObjectData(SerializationInfo, StreamingContext)

Implementa l'interfaccia ISerializable e restituisce i dati necessari a serializzare l'istanza di NameObjectCollectionBase.Implements the ISerializable interface and returns the data needed to serialize the NameObjectCollectionBase instance.

(Ereditato da NameObjectCollectionBase)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
OnDeserialization(Object)

Implementa l'interfaccia ISerializable e genera l'evento di deserializzazione quando la deserializzazione è completa.Implements the ISerializable interface and raises the deserialization event when the deserialization is complete.

(Ereditato da NameObjectCollectionBase)
Remove(String)

Rimuove il cookie con il nome specificato dalla raccolta.Removes the cookie with the specified name from the collection.

Set(HttpCookie)

Aggiorna il valore di un cookie esistente in una raccolta di cookie.Updates the value of an existing cookie in a cookie collection.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(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.Copies the entire NameObjectCollectionBase to a compatible one-dimensional Array, starting at the specified index of the target array.

(Ereditato da NameObjectCollectionBase)
ICollection.IsSynchronized

Ottiene un valore che indica se l'accesso all'oggetto NameObjectCollectionBase è sincronizzato (thread-safe).Gets a value indicating whether access to the NameObjectCollectionBase object is synchronized (thread safe).

(Ereditato da NameObjectCollectionBase)
ICollection.SyncRoot

Ottiene un oggetto che può essere usato per sincronizzare l'accesso all'oggetto NameObjectCollectionBase.Gets an object that can be used to synchronize access to the NameObjectCollectionBase object.

(Ereditato da NameObjectCollectionBase)

Metodi di estensione

Cast<TResult>(IEnumerable)

Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Consente la parallelizzazione di una query.Enables parallelization of a query.

AsQueryable(IEnumerable)

Converte un oggetto IEnumerable in un oggetto IQueryable.Converts an IEnumerable to an IQueryable.

Si applica a

Vedi anche