Cookie Constructors

Definitie

Initialiseert een nieuw exemplaar van de Cookie klasse. Over het algemeen hoeft een toepassing geen klasse te maken Cookie omdat deze automatisch wordt gemaakt op basis van de Set-Cookie header die is ontvangen met het HTTP-antwoord.

Overloads

Name Description
Cookie()

Initialiseert een nieuw exemplaar van de Cookie klasse.

Cookie(String, String)

Initialiseert een nieuw exemplaar van de Cookie klasse met een opgegeven Name en Value.

Cookie(String, String, String)

Initialiseert een nieuw exemplaar van de Cookie klasse met een opgegeven Name, Valueen Path.

Cookie(String, String, String, String)

Initialiseert een nieuw exemplaar van de Cookie klasse met een opgegeven Name, Value, Pathen Domain.

Initialiseert een nieuw exemplaar van de Cookie klasse.

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

Opmerkingen

De constructor zonder parameter initialiseert alle velden naar de standaardwaarden, met behulp van lege tekenreeksen ("") voor name, value, pathen domain. Houd er rekening mee dat ten minste de Name eigenschap moet worden geïnitialiseerd voordat u een exemplaar van de Cookie klasse gebruikt.

Van toepassing op

Initialiseert een nieuw exemplaar van de Cookie klasse met een opgegeven Name en Value.

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)

Parameters

name
String

De naam van een Cookie. De volgende tekens mogen niet worden gebruikt binnen name: gelijkteken, puntkomma, komma, newline (\n), return (\r), tab (\t) en spatieteken. Het dollarteken ($) mag niet het eerste teken zijn.

value
String

De waarde van een Cookie. De volgende tekens mogen niet worden gebruikt binnen value: puntkomma, komma.

Uitzonderingen

De name parameter is null.

– of –

De name parameter heeft een lengte van nul.

– of –

De name parameter bevat een ongeldig teken.

– of –

De value parameter is null .

-of-

De value parameter bevat een tekenreeks die niet tussen aanhalingstekens staat die een ongeldig teken bevat.

Opmerkingen

De standaardwaarde voor de value parameter maakt gebruik van de lege tekenreeks ("").

De parameter value voor een Cookie mag geen null verwijzing zijn (niets in Visual Basic). De tekens puntkomma (";") en komma (",") zijn gereserveerd en kunnen niet worden doorgegeven in de value parameter, tenzij de tekenreeks die in de value parameter wordt doorgegeven, tussen dubbele aanhalingstekens staat. De volgende voorbeeldconstructor zou dus slagen, maar wanneer u dit Cookie probeert toe te voegen aan een CookieContainer exemplaar met de Add(Cookie) of Add(Uri, Cookie) methoden, mislukt de bewerking en genereert u een uitzondering:

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

Met de volgende constructor met deze speciale tekens die zijn ontsnapt, wordt echter een Cookie constructor gemaakt die kan worden toegevoegd aan een CookieContainer exemplaar:

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

Het kommateken wordt gebruikt als scheidingsteken tussen afzonderlijke cookies op dezelfde regel.

Zie ook

Van toepassing op

Initialiseert een nieuw exemplaar van de Cookie klasse met een opgegeven Name, Valueen Path.

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)

Parameters

name
String

De naam van een Cookie. De volgende tekens mogen niet worden gebruikt binnen name: gelijkteken, puntkomma, komma, newline (\n), return (\r), tab (\t) en spatieteken. Het dollarteken ($) mag niet het eerste teken zijn.

value
String

De waarde van een Cookie. De volgende tekens mogen niet worden gebruikt binnen value: puntkomma, komma.

path
String

De subset van URI's op de oorspronkelijke server waarop dit Cookie van toepassing is. De standaardwaarde is '/'.

Uitzonderingen

De name parameter is null.

– of –

De name parameter heeft een lengte van nul.

– of –

De name parameter bevat een ongeldig teken.

– of –

De value parameter is null .

-of-

De value parameter bevat een tekenreeks die niet tussen aanhalingstekens staat die een ongeldig teken bevat.

Opmerkingen

De standaardwaarde voor de path parameter maakt gebruik van de lege tekenreeks ("").

De parameter value voor een Cookie mag geen null verwijzing zijn (niets in Visual Basic). De tekens puntkomma (";") en komma (",") zijn gereserveerd en kunnen niet worden doorgegeven in de value parameter, tenzij de tekenreeks die in de value parameter wordt doorgegeven, tussen dubbele aanhalingstekens staat. De volgende voorbeeldconstructor zou dus slagen, maar wanneer u dit Cookie probeert toe te voegen aan een CookieContainer exemplaar met de Add(Cookie) of Add(Uri, Cookie) methoden, mislukt de bewerking en genereert u een uitzondering:

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

Met de volgende constructor met deze speciale tekens die zijn ontsnapt, wordt echter een Cookie constructor gemaakt die kan worden toegevoegd aan een CookieContainer exemplaar:

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

Het kommateken wordt gebruikt als scheidingsteken tussen afzonderlijke cookies op dezelfde regel.

Zie ook

Van toepassing op

Initialiseert een nieuw exemplaar van de Cookie klasse met een opgegeven Name, Value, Pathen 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);
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)

Parameters

name
String

De naam van een Cookie. De volgende tekens mogen niet worden gebruikt binnen name: gelijkteken, puntkomma, komma, newline (\n), return (\r), tab (\t) en spatieteken. Het dollarteken ($) mag niet het eerste teken zijn.

value
String

De waarde van een Cookie object. De volgende tekens mogen niet worden gebruikt binnen value: puntkomma, komma.

path
String

De subset van URI's op de oorspronkelijke server waarop dit Cookie van toepassing is. De standaardwaarde is '/'.

domain
String

Het optionele internetdomein waarvoor dit Cookie geldig is. De standaardwaarde is de host van waaruit deze Cookie is ontvangen.

Uitzonderingen

De name parameter is null.

– of –

De name parameter heeft een lengte van nul.

– of –

De name parameter bevat een ongeldig teken.

– of –

De value parameter is null .

-of-

De value parameter bevat een tekenreeks die niet tussen aanhalingstekens staat die een ongeldig teken bevat.

Opmerkingen

De standaardwaarde voor de domain en path parameters maakt gebruik van de lege tekenreeks ("").

De parameter value voor een Cookie mag geen null verwijzing zijn (niets in Visual Basic). De tekens puntkomma (";") en komma (",") zijn gereserveerd en kunnen niet worden doorgegeven in de value parameter, tenzij de tekenreeks die in de value parameter wordt doorgegeven, tussen dubbele aanhalingstekens staat. De volgende voorbeeldconstructor zou dus slagen, maar wanneer u dit Cookie probeert toe te voegen aan een CookieContainer exemplaar met de Add(Cookie) of Add(Uri, Cookie) methoden, mislukt de bewerking en genereert u een uitzondering:

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

Met de volgende constructor met deze speciale tekens die zijn ontsnapt, wordt echter een Cookie constructor gemaakt die kan worden toegevoegd aan een CookieContainer exemplaar:

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

Het kommateken wordt gebruikt als scheidingsteken tussen afzonderlijke cookies op dezelfde regel.

Zie ook

Van toepassing op