HttpCookieCollection Classe
Definizione
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::NameObjectCollectionBasepublic sealed class HttpCookieCollection : System.Collections.Specialized.NameObjectCollectionBasetype HttpCookieCollection = class
inherit NameObjectCollectionBasePublic NotInheritable Class HttpCookieCollection
Inherits NameObjectCollectionBase- Ereditarietà
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 |
| 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. |
