Cookie Classe

Definizione

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

public ref class Cookie sealed
public sealed class Cookie
[System.Serializable]
public sealed class Cookie
type Cookie = class
[<System.Serializable>]
type Cookie = class
Public NotInheritable Class Cookie
Ereditarietà
Cookie
Attributi

Esempio

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

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
*/
Imports System.Net

' This example is run at the command line.
' Specify one argument: the name of the host to 
' receive the request.
' If the request is sucessful, the example displays the contents of the cookies
' returned by the host.

Public Class CookieExample
    
    Public Shared Sub Main(args() As String)
        If args Is Nothing OrElse args.Length <> 1 Then
            Console.WriteLine("Specify the URL to receive the request.")
            Environment.Exit(1)
        End If
        Dim request As HttpWebRequest = WebRequest.Create(args(0))
        request.CookieContainer = New CookieContainer()
    
        Using response As HttpWebResponse = request.GetResponse()
            ' Print the properties of each cookie.
            For Each cook As Cookie 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 {If(cook.Version = 1, 2109, 2965)}")
    
                ' Show the string representation of the cookie.
                Console.WriteLine($"String: {cook}")
            Next
        End Using
    End Sub
End Class



' 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. Durante l'analisi delle intestazioni di risposta HTTP sono supportati i formati di cookie seguenti: la specifica Netscape originale, RFC 2109 e RFC 2965.

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

Costruttori

Nome Descrizione
Cookie()

Inizializza una nuova istanza della classe Cookie.

Cookie(String, String, String, String)

Inizializza una nuova istanza della classe Cookie con un Namespecificato, Value, Pathe Domain.

Cookie(String, String, String)

Inizializza una nuova istanza della classe Cookie con un Namespecificato, Valuee Path.

Cookie(String, String)

Inizializza una nuova istanza della classe Cookie con un Name e un Valuespecificati.

Proprietà

Nome Descrizione
Comment

Ottiene o imposta un commento che il server può aggiungere a un oggetto Cookie.

CommentUri

Ottiene o imposta un commento URI che il server può fornire con un oggetto Cookie.

Discard

Ottiene o imposta il flag discard impostato dal server.

Domain

Ottiene o imposta l'URI per il quale l'oggetto Cookie è valido.

Expired

Ottiene o imposta lo stato corrente dell'oggetto Cookie.

Expires

Ottiene o imposta la data e l'ora Cookie di scadenza di come oggetto DateTime.

HttpOnly

Determina se uno script di pagina o un altro contenuto attivo può accedere a questo cookie.

Name

Ottiene o imposta il nome per l'oggetto Cookie.

Path

Ottiene o imposta gli URI a cui si applica l'oggetto Cookie .

Port

Ottiene o imposta un elenco di porte TCP a cui si applica l'oggetto Cookie .

Secure

Ottiene o imposta il livello di sicurezza di un oggetto Cookie.

TimeStamp

Ottiene l'ora in cui il cookie è stato emesso come .DateTime

Value

Ottiene o imposta l'oggetto Value per l'oggetto Cookie.

Version

Ottiene o imposta la versione della manutenzione dello stato HTTP a cui è conforme il cookie.

Metodi

Nome Descrizione
Equals(Object)

Esegue l'override del Equals(Object) metodo .

GetHashCode()

Esegue l'override del GetHashCode() metodo .

GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
ToString()

Esegue l'override del ToString() metodo .

Si applica a

Vedi anche