Cookie Constructeurs

Définition

Espace de noms:: System.Net

Assemblys:: System.dll, System.Net.Primitives.dll

Assemblys:: netstandard.dll, System.Net.Primitives.dll

Assembly:: System.Net.Primitives.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

Surcharges

Nom	Description
Cookie()	Initialise une nouvelle instance de la classe Cookie.
Cookie(String, String)	Initialise une nouvelle instance de la Cookie classe avec un élément spécifié Name et Value.
Cookie(String, String, String)	Initialise une nouvelle instance de la Cookie classe avec un Name, Valueet Path.
Cookie(String, String, String, String)	Initialise une nouvelle instance de la Cookie classe avec un Name, , Value Pathet Domain.

Source:: Cookie.cs

Source:: Cookie.cs

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 une instance de la Cookie classe.

S’applique à

Source:: Cookie.cs

Source:: Cookie.cs

Source:: Cookie.cs

Source:: Cookie.cs

Source:: Cookie.cs

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

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 d’un Cookie. Les caractères suivants ne doivent pas être utilisés à l’intérieur name: signe égal, point-virgule, virgule, nouvelle ligne (\n), retour (\r), tabulation (\t) et espacement. Le caractère de signe dollar (« $ ») ne peut pas être le premier caractère.

value: String

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

Exceptions

CookieException

Le name paramètre est null.

- ou -

Le name paramètre est de longueur nulle.

- ou -

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

- ou -

Le value paramètre est null .

-ou -

Le value paramètre contient une chaîne non placée entre guillemets qui contient 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). Les points-virgules (« ; ») et les caractères (« , ») sont réservés et ne peuvent pas être transmis 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 à une CookieContainer instance avec les méthodes ou Add(Uri, Cookie) les Add(Cookie) méthodes, 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 échappés crée un Cookie élément qui peut être ajouté à une CookieContainer instance :

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

Le caractère de 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

Source:: Cookie.cs

Source:: Cookie.cs

Initialise une nouvelle instance de la Cookie classe avec un Name, Valueet 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)

Paramètres

name: String

value: String

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

path: String

Sous-ensemble d’URI sur le serveur d’origine auquel cela s’applique Cookie . La valeur par défaut est « / ».

Exceptions

CookieException

Le name paramètre est null.

- ou -

Le name paramètre est de longueur nulle.

- ou -

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

- ou -

Le value paramètre est null .

-ou -

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

Remarques

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

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 échappés crée un Cookie élément qui peut être ajouté à une CookieContainer instance :

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

Le caractère de 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

Source:: Cookie.cs

Source:: Cookie.cs

Initialise une nouvelle instance de la Cookie classe avec un Name, , Value Pathet 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)

Paramètres

name: String

value: String

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

path: String

Sous-ensemble d’URI sur le serveur d’origine auquel cela s’applique Cookie . La valeur par défaut est « / ».

domain: String

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

Exceptions

CookieException

Le name paramètre est null.

- ou -

Le name paramètre est de longueur nulle.

- ou -

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

- ou -

Le value paramètre est null .

-ou -

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

Remarques

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

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 échappés crée un Cookie élément qui peut être ajouté à une CookieContainer instance :

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

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

Voir aussi

S’applique à

Commentaires

Cette page a-t-elle été utile ?

Partager via

Cookie Constructeurs

Définition

Surcharges

Cookie()

Remarques

S’applique à

Cookie(String, String)

Paramètres

Exceptions

Remarques

Voir aussi

S’applique à

Cookie(String, String, String)

Paramètres

Exceptions

Remarques

Voir aussi

S’applique à

Cookie(String, String, String, String)

Paramètres

Exceptions

Remarques

Voir aussi

S’applique à

Commentaires