Condividi tramite

Cookie Costruttori

  • Riferimento

Definizione

Spazio dei nomi:
System.Net
Assembly:
System.Net.Primitives.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Inizializza una nuova istanza della classe Cookie. In generale, un'applicazione non deve costruire una classe Cookie perché 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 un Name e un Valuespecificati.
Cookie(String, String, String)

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

Inizializza una nuova istanza della classe Cookie con un Namespecificato, Value, Pathe Domain.
Origine:
Cookie.cs
Origine:
Cookie.cs
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 sui valori predefiniti, usando stringhe vuote ("") per name, value, pathe domain. Si noti che almeno la proprietà Name deve essere inizializzata prima di usare un'istanza della classe Cookie.

Si applica a

Origine:
Cookie.cs
Origine:
Cookie.cs
Origine:
Cookie.cs

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

public:
 Cookie(System::String ^ name, System::String ^ value);
public Cookie (string name, 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

Nome di un Cookie. I caratteri seguenti non devono essere usati all'interno di name: segno di uguale, punto e virgola, virgola, nuova riga (\n), restituire (\r), tabulazioni (\t) e spazio. Il carattere simbolo di dollaro ("$") non può essere il primo carattere.

value
String

Valore di un Cookie. I caratteri seguenti non devono essere usati all'interno di value: punto e virgola, virgola.

Eccezioni

CookieException

Il parametro name è null.

-o-

Il parametro name è di lunghezza zero.

-o-

Il parametro name contiene un carattere non valido.

-o-

Il parametro value è null .

-o-

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

Commenti

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

Il parametro value per un Cookie non deve essere un riferimento null (Nothing in Visual Basic). I caratteri punto e virgola (";") e virgola (",") sono riservati e non possono essere passati nel parametro value a meno che la stringa passata nel parametro value non sia racchiusa tra virgolette doppie. Il costruttore di esempio seguente avrà esito positivo, ma quando si tenta di aggiungere questa Cookie a un'istanza di CookieContainer con i metodi Add(Cookie) 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 preceduti da escape creerà un Cookie che può essere aggiunto a un'istanza di 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

Si applica a

Origine:
Cookie.cs
Origine:
Cookie.cs
Origine:
Cookie.cs

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

public:
 Cookie(System::String ^ name, System::String ^ value, System::String ^ path);
public Cookie (string name, string value, 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

Nome di un Cookie. I caratteri seguenti non devono essere usati all'interno di name: segno di uguale, punto e virgola, virgola, nuova riga (\n), restituire (\r), tabulazioni (\t) e spazio. Il carattere simbolo di dollaro ("$") non può essere il primo carattere.

value
String

Valore di un Cookie. I caratteri seguenti non devono essere usati all'interno di value: punto e virgola, virgola.

path
String

Sottoinsieme di URI nel server di origine a cui si applica questa Cookie. Il valore predefinito è "/".

Eccezioni

CookieException

Il parametro name è null.

-o-

Il parametro name è di lunghezza zero.

-o-

Il parametro name contiene un carattere non valido.

-o-

Il parametro value è null .

-o-

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

Commenti

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

Il parametro value per un Cookie non deve essere un riferimento null (Nothing in Visual Basic). I caratteri punto e virgola (";") e virgola (",") sono riservati e non possono essere passati nel parametro value a meno che la stringa passata nel parametro value non sia racchiusa tra virgolette doppie. Il costruttore di esempio seguente avrà esito positivo, ma quando si tenta di aggiungere questa Cookie a un'istanza di CookieContainer con i metodi Add(Cookie) 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 preceduti da escape creerà un Cookie che può essere aggiunto a un'istanza di 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

Si applica a

Origine:
Cookie.cs
Origine:
Cookie.cs
Origine:
Cookie.cs

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

public:
 Cookie(System::String ^ name, System::String ^ value, System::String ^ path, System::String ^ domain);
public Cookie (string name, string value, string path, 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

Nome di un Cookie. I caratteri seguenti non devono essere usati all'interno di name: segno di uguale, punto e virgola, virgola, nuova riga (\n), restituire (\r), tabulazioni (\t) e spazio. Il carattere simbolo di dollaro ("$") non può essere il primo carattere.

value
String

Valore di un oggetto Cookie. I caratteri seguenti non devono essere usati all'interno di value: punto e virgola, virgola.

path
String

Sottoinsieme di URI nel server di origine a cui si applica questa Cookie. Il valore predefinito è "/".

domain
String

Dominio Internet facoltativo per il quale questo Cookie è valido. Il valore predefinito è l'host da cui è stato ricevuto questo Cookie.

Eccezioni

CookieException

Il parametro name è null.

-o-

Il parametro name è di lunghezza zero.

-o-

Il parametro name contiene un carattere non valido.

-o-

Il parametro value è null .

-o-

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

Commenti

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

Il parametro value per un Cookie non deve essere un riferimento null (Nothing in Visual Basic). I caratteri punto e virgola (";") e virgola (",") sono riservati e non possono essere passati nel parametro value a meno che la stringa passata nel parametro value non sia racchiusa tra virgolette doppie. Il costruttore di esempio seguente avrà esito positivo, ma quando si tenta di aggiungere questa Cookie a un'istanza di CookieContainer con i metodi Add(Cookie) 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 preceduti da escape creerà un Cookie che può essere aggiunto a un'istanza di 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

Si applica a