Cookie Costruttori

Definizione

Spazio dei nomi:

System.Net

Assembly:

System.Net.Primitives.dll

Inizializza una nuova istanza della classe Cookie. In generale, non è necessario che un'applicazione costruisca una classe Cookie poiché viene creata automaticamente in base all'intestazione Set-Cookie ricevuta con la risposta HTTP.

Overload

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.

Cookie()

Origine:

Cookie.cs

Inizializza una nuova istanza della classe Cookie.

public:
 Cookie();

public Cookie ();

Public Sub New ()

Commenti

Il costruttore senza parametri inizializza tutti i campi ai relativi valori predefiniti, usando stringhe vuote ("") per name, pathvalue, e domain. Si noti che almeno la Name proprietà deve essere inizializzata prima di usare un'istanza della Cookie classe.

Cookie(String, String)

Origine:

Cookie.cs

Inizializza una nuova istanza della classe Cookie con gli oggetti Name e Value specificati.

public:
 Cookie(System::String ^ name, System::String ^ value);

public Cookie (string name, string? value);

new System.Net.Cookie : string * string -> System.Net.Cookie

Public Sub New (name As String, value As String)

Parametri

name

String

Il nome di un Cookie. All'interno di name non è possibile utilizzare i caratteri seguenti: segno di uguale, punto e virgola, virgola, nuova riga (\n), ritorno a capo (\r), tabulazione (\t) e spazio. Il simbolo del dollaro ("$") non può trovarsi in prima posizione.

value

String

Valore di un Cookie. All'interno di value non è possibile utilizzare i caratteri indicati di seguito: punto e virgola, virgola.

Eccezioni

CookieException

Il valore del parametro name è null.

-oppure-

La lunghezza del parametro name è zero.

-oppure-

Il parametro name contiene un carattere non valido.

-oppure-

Il parametro value è null .

-oppure-

Il parametro value contiene una stringa non racchiusa tra virgolette che contiene un carattere non valido.

Commenti

Il valore predefinito per il value parametro usa la stringa vuota ("").

Il value parametro per un Cookie non deve essere un null riferimento (Nothing in Visual Basic). I caratteri e virgola (";") e virgole (",") sono riservati e non possono essere passati nel value parametro a meno che la stringa passata nel value parametro sia racchiusa tra virgolette doppie. Il costruttore di esempio seguente avrà esito positivo, ma quando si tenta di aggiungerlo Cookie a un'istanza CookieContainer con i Add(Cookie) metodi o Add(Uri, Cookie) , l'operazione avrà esito negativo e genererà un'eccezione:

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "123,456");
cookie.Domain = "contoso.com";
new CookieContainer().Add(cookie);

Tuttavia, il costruttore seguente con questi caratteri speciali escape creerà un Cookie oggetto che può essere aggiunto a un'istanza CookieContainer :

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "\"123,456\"");
cookie.Domain = "contoso.com";
new CookieContainer().Add(cookie);

Il carattere virgola viene usato come delimitatore tra cookie separati nella stessa riga.

Vedi anche

• CookieCollection
• CookieContainer
• CookieException

Cookie(String, String, String)

Origine:

Cookie.cs

Inizializza una nuova istanza della classe Cookie con un Name, un Value e un Path specificati.

public:
 Cookie(System::String ^ name, System::String ^ value, System::String ^ path);

public Cookie (string name, string? value, string? path);

new System.Net.Cookie : string * string * string -> System.Net.Cookie

Public Sub New (name As String, value As String, path As String)

Parametri

name

String

Il nome di un Cookie. All'interno di name non è possibile utilizzare i caratteri seguenti: segno di uguale, punto e virgola, virgola, nuova riga (\n), ritorno a capo (\r), tabulazione (\t) e spazio. Il simbolo del dollaro ("$") non può trovarsi in prima posizione.

value

String

Valore di un Cookie. All'interno di value non è possibile utilizzare i caratteri indicati di seguito: punto e virgola, virgola.

path

String

Il sottoinsieme di URI sul server di origine al quale si applica questo Cookie. Il valore predefinito è "/".

Eccezioni

CookieException

Il valore del parametro name è null.

-oppure-

La lunghezza del parametro name è zero.

-oppure-

Il parametro name contiene un carattere non valido.

-oppure-

Il parametro value è null .

-oppure-

Il parametro value contiene una stringa non racchiusa tra virgolette che contiene un carattere non valido.

Commenti

Il valore predefinito per il path parametro usa la stringa vuota ("").

Il value parametro per un Cookie non deve essere un null riferimento (Nothing in Visual Basic). I caratteri e virgola (";") e virgole (",") sono riservati e non possono essere passati nel value parametro a meno che la stringa passata nel value parametro sia racchiusa tra virgolette doppie. Il costruttore di esempio seguente avrà esito positivo, ma quando si tenta di aggiungerlo Cookie a un'istanza CookieContainer con i Add(Cookie) metodi o Add(Uri, Cookie) , l'operazione avrà esito negativo e genererà un'eccezione:

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "123,456", "");
cookie.Domain = "contoso.com";
new CookieContainer().Add(cookie);

Tuttavia, il costruttore seguente con questi caratteri speciali escape creerà un Cookie oggetto che può essere aggiunto a un'istanza CookieContainer :

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "\"123,456\"", "");
cookie.Domain = "contoso.com";
new CookieContainer().Add(cookie);

Il carattere virgola viene usato come delimitatore tra cookie separati nella stessa riga.

Vedi anche

• CookieCollection
• CookieContainer
• CookieException

Cookie(String, String, String, String)

Origine:

Cookie.cs

Inizializza una nuova istanza della classe Cookie con un Name, un Value, un Path e un Domain specificati.

public:
 Cookie(System::String ^ name, System::String ^ value, System::String ^ path, System::String ^ domain);

public Cookie (string name, string? value, string? path, string? domain);

new System.Net.Cookie : string * string * string * string -> System.Net.Cookie

Public Sub New (name As String, value As String, path As String, domain As String)

Parametri

name

String

Il nome di un Cookie. All'interno di name non è possibile utilizzare i caratteri seguenti: segno di uguale, punto e virgola, virgola, nuova riga (\n), ritorno a capo (\r), tabulazione (\t) e spazio. Il simbolo del dollaro ("$") non può trovarsi in prima posizione.

value

String

Valore di un oggetto Cookie. All'interno di value non è possibile utilizzare i caratteri indicati di seguito: punto e virgola, virgola.

path

String

Il sottoinsieme di URI sul server di origine al quale si applica questo Cookie. Il valore predefinito è "/".

domain

String

Il dominio Internet facoltativo per il quale è valido questo Cookie. Il valore predefinito è l'host dal quale è stato ricevuto questo Cookie.

Eccezioni

CookieException

Il valore del parametro name è null.

-oppure-

La lunghezza del parametro name è zero.

-oppure-

Il parametro name contiene un carattere non valido.

-oppure-

Il parametro value è null .

-oppure-

Il parametro value contiene una stringa non racchiusa tra virgolette che contiene un carattere non valido.

Commenti

Il valore predefinito per i domain parametri e path usa la stringa vuota ("").

Il value parametro per un Cookie non deve essere un null riferimento (Nothing in Visual Basic). I caratteri e virgola (";") e virgole (",") sono riservati e non possono essere passati nel value parametro a meno che la stringa passata nel value parametro sia racchiusa tra virgolette doppie. Il costruttore di esempio seguente avrà esito positivo, ma quando si tenta di aggiungerlo Cookie a un'istanza CookieContainer con i Add(Cookie) metodi o Add(Uri, Cookie) , l'operazione avrà esito negativo e genererà un'eccezione:

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "123,456", "", "contoso.com");
new CookieContainer().Add(cookie);

Tuttavia, il costruttore seguente con questi caratteri speciali escape creerà un Cookie oggetto che può essere aggiunto a un'istanza CookieContainer :

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "\"123,456\"", "", "contoso.com");
new CookieContainer().Add(cookie);

Il carattere virgola viene usato come delimitatore tra cookie separati nella stessa riga.

Vedi anche

• CookieCollection
• CookieContainer
• CookieException