Cookie Classe

Definizione

Spazio dei nomi:

System.Net

Assembly:

System.Net.Primitives.dll

Origine:

Cookie.cs

Fornisce un set di proprietà e metodi usati per gestire i cookie. La classe non può essere ereditata.

C#

public sealed class Cookie

Ereditarietà

Object

Cookie

Esempio

Nell'esempio seguente viene inviata una richiesta a un URL e vengono visualizzati i cookie restituiti nella risposta.

C#

using System.Net;
using System;
namespace Examples.System.Net.Cookies
{
    // This example is run at the command line.
    // Specify one argument: the name of the host to
    // send the request to.
    // If the request is sucessful, the example displays the contents of the cookies
    // returned by the host.

    public class CookieExample
    {
        public static void Main(string[] args)
        {
            if (args == null || args.Length != 1)
            {
                Console.WriteLine("Specify the URL to receive the request.");
                Environment.Exit(1);
            }
            var request = (HttpWebRequest)WebRequest.Create(args[0]);
            request.CookieContainer = new CookieContainer();

            using (var response = (HttpWebResponse) request.GetResponse())
            {
                // Print the properties of each cookie.
                foreach (Cookie cook in response.Cookies)
                {
                    Console.WriteLine("Cookie:");
                    Console.WriteLine($"{cook.Name} = {cook.Value}");
                    Console.WriteLine($"Domain: {cook.Domain}");
                    Console.WriteLine($"Path: {cook.Path}");
                    Console.WriteLine($"Port: {cook.Port}");
                    Console.WriteLine($"Secure: {cook.Secure}");

                    Console.WriteLine($"When issued: {cook.TimeStamp}");
                    Console.WriteLine($"Expires: {cook.Expires} (expired? {cook.Expired})");
                    Console.WriteLine($"Don't save: {cook.Discard}");
                    Console.WriteLine($"Comment: {cook.Comment}");
                    Console.WriteLine($"Uri for comments: {cook.CommentUri}");
                    Console.WriteLine($"Version: RFC {(cook.Version == 1 ? 2109 : 2965)}");

                    // Show the string representation of the cookie.
                    Console.WriteLine($"String: {cook}");
                }
            }
        }
    }
}

// Output from this example will be vary depending on the host name specified,
// but will be similar to the following.
/*
Cookie:
CustomerID = 13xyz
Domain: .contoso.com
Path: /
Port:
Secure: False
When issued: 1/14/2003 3:20:57 PM
Expires: 1/17/2013 11:14:07 AM (expired? False)
Don't save: False
Comment:
Uri for comments:
Version: RFC 2965
String: CustomerID = 13xyz
*/

Commenti

La Cookie classe viene usata da un'applicazione client per recuperare informazioni sui cookie ricevuti con risposte HTTP. I formati di cookie seguenti sono supportati durante l'analisi delle intestazioni di risposta HTTP: la specifica Netscape originale, RFC 2109 e RFC 2965.

Per un elenco dei valori delle proprietà iniziali per un'istanza di Cookie, vedere i vari Cookie costruttori.

Costruttori

Cookie()	Inizializza una nuova istanza della classe Cookie.
Cookie(String, String)	Inizializza una nuova istanza della classe Cookie con gli oggetti Name e Value specificati.
Cookie(String, String, String)	Inizializza una nuova istanza della classe Cookie con un Name, un Value e un Path specificati.
Cookie(String, String, String, String)	Inizializza una nuova istanza della classe Cookie con un Name, un Value, un Path e un Domain specificati.

Proprietà

Comment	Ottiene o imposta un commento che il server può aggiungere a un Cookie.
CommentUri	Ottiene o imposta un commento URI che il server può fornire con un Cookie.
Discard	Ottiene o imposta il flag di eliminazione impostato dal server.
Domain	Ottiene o imposta l'URI per il quale è valido il Cookie.
Expired	Ottiene o imposta lo stato corrente del Cookie.
Expires	Ottiene o imposta la data e l'ora di scadenza del Cookie come DateTime.
HttpOnly	Determina se per uno script di pagina o un altro contenuto attivo è possibile accedere a questo cookie.
Name	Ottiene o imposta il nome per Cookie.
Path	Ottiene o imposta gli URI ai quali si applica il Cookie.
Port	Ottiene o imposta un elenco di porte TCP alle quali si applica il Cookie.
Secure	Ottiene o imposta il livello di sicurezza di un Cookie.
TimeStamp	Ottiene l'ora di emissione del cookie come DateTime.
Value	Ottiene o imposta l'oggetto Value per Cookie.
Version	Ottiene o imposta la versione della manutenzione dello stato HTTP a cui è conforme il cookie.

Metodi

Equals(Object)	Esegue l'override del metodo Equals(Object).
GetHashCode()	Esegue l'override del metodo GetHashCode().
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Esegue l'override del metodo ToString().

Si applica a

Vedi anche

• CookieCollection
• CookieContainer
• CookieException