Cookie Constructeurs

  • Référence

Définition

Espace de noms:
System.Net
Assembly:
System.Net.Primitives.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Initialise une nouvelle instance de la classe Cookie. En général, une application n'a pas besoin de construire une classe Cookie puisqu'elle est créée automatiquement en fonction de l'en-tête Set-Cookie reçu avec la réponse HTTP.

Surcharges

Cookie()

Initialise une nouvelle instance de la classe Cookie.
Cookie(String, String)

Initialise une nouvelle instance de la classe Cookie avec un Name et un Value spécifiés.
Cookie(String, String, String)

Initialise une nouvelle instance de la classe Cookie avec les Name, Value et Path spécifiés.
Cookie(String, String, String, String)

Initialise une nouvelle instance de la classe Cookie avec les Name, Value, Path et Domain spécifiés.
Source:
Cookie.cs
Source:
Cookie.cs
Source:
Cookie.cs

Initialise une nouvelle instance de la classe Cookie.

public:
 Cookie();
public Cookie ();
Public Sub New ()

Remarques

Le constructeur sans paramètre initialise tous les champs à leurs valeurs par défaut, à l’aide de chaînes vides («  ») pour name, value, pathet domain. Notez qu’au moins la Name propriété doit être initialisée avant d’utiliser un instance de la Cookie classe .

S’applique à

Source:
Cookie.cs
Source:
Cookie.cs
Source:
Cookie.cs

Initialise une nouvelle instance de la classe Cookie avec un Name et un Value spécifiés.

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)

Paramètres

name
String

Nom de Cookie. Les caractères suivants ne doivent pas être utilisés à l'intérieur de name : signe égal, point-virgule, virgule, saut de ligne (\n), retour (\r), tabulation (\t) et espace blanc. Le symbole du dollar ("$") ne peut pas être le premier caractère.

value
String

Valeur de Cookie. Les caractères suivants ne doivent pas être utilisés à l'intérieur de value : point-virgule, virgule.

Exceptions

CookieException

Le paramètre name a la valeur null.

- ou -

Le paramètre name est de longueur nulle.

- ou -

Le paramètre name contient un caractère non valide.

- ou -

Le paramètre value a la valeur null.

ou

Le paramètre value contient une chaîne non indiquée entre guillemets qui comprend un caractère non valide.

Remarques

La valeur par défaut du value paramètre utilise la chaîne vide («  »).

Le value paramètre d’un Cookie ne doit pas être une null référence (Nothing en Visual Basic). Le point-virgule (« ; ») et la virgule (« , ») sont réservés et ne peuvent pas être passés dans le value paramètre, sauf si la chaîne passée dans le value paramètre est placée entre guillemets doubles. Par conséquent, l’exemple de constructeur suivant réussit, mais lorsque vous essayez d’ajouter ceci Cookie à un CookieContainer instance avec les Add(Cookie) méthodes ou Add(Uri, Cookie) , l’opération échoue et lève une exception :

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

Toutefois, le constructeur suivant avec ces caractères spéciaux placés dans une séquence d’échappement crée un Cookie qui peut être ajouté à un CookieContainer instance :

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

Le caractère virgule est utilisé comme délimiteur entre des cookies distincts sur la même ligne.

Voir aussi

S’applique à

Source:
Cookie.cs
Source:
Cookie.cs
Source:
Cookie.cs

Initialise une nouvelle instance de la classe Cookie avec les Name, Value et Path spécifiés.

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)

Paramètres

name
String

Nom de Cookie. Les caractères suivants ne doivent pas être utilisés à l'intérieur de name : signe égal, point-virgule, virgule, saut de ligne (\n), retour (\r), tabulation (\t) et espace blanc. Le symbole du dollar ("$") ne peut pas être le premier caractère.

value
String

Valeur de Cookie. Les caractères suivants ne doivent pas être utilisés à l'intérieur de value : point-virgule, virgule.

path
String

Sous-ensemble d'URI sur le serveur d'origine auquel ce Cookie s'applique. La valeur par défaut est "/".

Exceptions

CookieException

Le paramètre name a la valeur null.

- ou -

Le paramètre name est de longueur nulle.

- ou -

Le paramètre name contient un caractère non valide.

- ou -

Le paramètre value a la valeur null.

ou

Le paramètre value contient une chaîne non indiquée entre guillemets qui comprend un caractère non valide.

Remarques

La valeur par défaut du path paramètre utilise la chaîne vide («  »).

Le value paramètre d’un Cookie ne doit pas être une null référence (Nothing en Visual Basic). Le point-virgule (« ; ») et la virgule (« , ») sont réservés et ne peuvent pas être passés dans le value paramètre, sauf si la chaîne passée dans le value paramètre est placée entre guillemets doubles. Par conséquent, l’exemple de constructeur suivant réussit, mais lorsque vous essayez d’ajouter ceci Cookie à un CookieContainer instance avec les Add(Cookie) méthodes ou Add(Uri, Cookie) , l’opération échoue et lève une exception :

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

Toutefois, le constructeur suivant avec ces caractères spéciaux placés dans une séquence d’échappement crée un Cookie qui peut être ajouté à un CookieContainer instance :

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

Le caractère virgule est utilisé comme délimiteur entre des cookies distincts sur la même ligne.

Voir aussi

S’applique à

Source:
Cookie.cs
Source:
Cookie.cs
Source:
Cookie.cs

Initialise une nouvelle instance de la classe Cookie avec les Name, Value, Path et Domain spécifiés.

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)

Paramètres

name
String

Nom de Cookie. Les caractères suivants ne doivent pas être utilisés à l'intérieur de name : signe égal, point-virgule, virgule, saut de ligne (\n), retour (\r), tabulation (\t) et espace blanc. Le symbole du dollar ("$") ne peut pas être le premier caractère.

value
String

Valeur d'un objet Cookie. Les caractères suivants ne doivent pas être utilisés à l'intérieur de value : point-virgule, virgule.

path
String

Sous-ensemble d'URI sur le serveur d'origine auquel ce Cookie s'applique. La valeur par défaut est "/".

domain
String

Domaine Internet facultatif pour lequel Cookie est valide. La valeur par défaut correspond à l'hôte à partir duquel Cookie a été reçu.

Exceptions

CookieException

Le paramètre name a la valeur null.

- ou -

Le paramètre name est de longueur nulle.

- ou -

Le paramètre name contient un caractère non valide.

- ou -

Le paramètre value a la valeur null.

ou

Le paramètre value contient une chaîne non indiquée entre guillemets qui comprend un caractère non valide.

Remarques

La valeur par défaut des domain paramètres et path utilise la chaîne vide («  »).

Le value paramètre d’un Cookie ne doit pas être une null référence (Nothing en Visual Basic). Le point-virgule (« ; ») et la virgule (« , ») sont réservés et ne peuvent pas être passés dans le value paramètre, sauf si la chaîne passée dans le value paramètre est placée entre guillemets doubles. Par conséquent, l’exemple de constructeur suivant réussit, mais lorsque vous essayez d’ajouter ceci Cookie à un CookieContainer instance avec les Add(Cookie) méthodes ou Add(Uri, Cookie) , l’opération échoue et lève une exception :

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

Toutefois, le constructeur suivant avec ces caractères spéciaux placés dans une séquence d’échappement crée un Cookie qui peut être ajouté à un CookieContainer instance :

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

Le caractère virgule est utilisé comme délimiteur entre des cookies distincts sur la même ligne.

Voir aussi

S’applique à