HttpCookie(String, String, String) Constructeur

Définition

Espace de noms:

Windows.Web.Http

Initialise une nouvelle instance de la classe HttpCookie avec un nom, un domaine et un chemin d’accès spécifiés.

public:
 HttpCookie(Platform::String ^ name, Platform::String ^ domain, Platform::String ^ path);

 HttpCookie(winrt::hstring const& name, winrt::hstring const& domain, winrt::hstring const& path);

public HttpCookie(string name, string domain, string path);

function HttpCookie(name, domain, path)

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

Paramètres

name

String

Platform::String

winrt::hstring

Nom de l’objet HttpCookie

domain

String

Platform::String

winrt::hstring

Domaine pour lequel HttpCookie est valide.

path

String

Platform::String

winrt::hstring

URI auxquels httpcookie s’applique.

Remarques

Le paramètre name de HttpCookie ne peut pas être défini sur null (Nothing en Visual Basic).

La propriété doit être un jeton tel que défini dans RFC 2616 et RFC 6265.

Les caractères suivants sont utilisés comme séparateurs et ne peuvent pas être utilisés dans le paramètre name :

• paren gauche ('(')
• right paren (')')
• supérieur à ('>')
• inférieur à ('<')
• signe at ('@')
• virgule (',')
• Point-virgule (';')
• deux points (' :')
• barre oblique inverse ('\')
• guillemet double ('"')
• barre oblique ('/')
• crochet gauche ('[')
• crochet droit (']')
• point d’interrogation (' ?')
• signe égal ('=')
• crochet gauche ondulée ('{')
• crochet droit ondulée ('}')
• nouvelle ligne (« \n »)
• return ('\r »)
• space (' ')
• tab ('\t »)

Le paramètre *domain * spécifie les hôtes auxquels httpCookie sera envoyé. Un cookie avec un paramètre *domain * de .contoso.com est envoyé au domaine et à contoso.com tous les sous-domaines (www.contoso.com et info.contoso.com, par exemple).

Un cookie avec un paramètre *domain * de info.contoso.com ne sera pas envoyé à contoso.com ou www.contoso.com, mais sera envoyé à et à info.contoso.com tous les sous-domaines (uk.info.contoso.com et us.info.contoso.com, par exemple).

Si le paramètre de domaine n’est pas spécifié, httpCookie est envoyé uniquement à l’hôte et aux sous-domaines de l’hôte à partir duquel ce cookie a été reçu.

Le paramètre path spécifie le sous-ensemble de chemins d’accès sur le serveur d’origine auquel ce HttpCookie s’applique . Si ce paramètre n’est pas spécifié, le chemin par défaut correspond à n’importe quel chemin et httpCookie est envoyé sur toutes les requêtes HTTP au paramètre *domain * spécifié et à tous les sous-domaines.