Cookie Konstruktory

Definice

Obor názvů:

System.Net

Sestavení:

netstandard.dll, System.Net.Primitives.dll

Inicializuje novou instanci Cookie třídy. Obecně platí, že aplikace nemusí sestavit Cookie třídu, protože je vytvořena automaticky na základě hlavičky Set-Cookie přijaté s odpovědí HTTP.

Přetížení

Name	Description
Cookie()	Inicializuje novou instanci Cookie třídy.
Cookie(String, String)	Inicializuje novou instanci Cookie třídy se zadaným Name a Value.
Cookie(String, String, String)	Inicializuje novou instanci Cookie třídy se zadaným Name, Valuea Path.
Cookie(String, String, String, String)	Inicializuje novou instanci Cookie třídy se zadaným Name, Value, Patha Domain.

Cookie()

Zdroj:

Cookie.cs

Inicializuje novou instanci Cookie třídy.

public:
 Cookie();

public Cookie();

Public Sub New ()

Poznámky

Konstruktor bez parametrů inicializuje všechna pole na výchozí hodnoty pomocí prázdných řetězců ("") pro name, value, patha domain. Mějte na paměti, že před použitím instance Cookie třídy musí být inicializována alespoň Name vlastnost.

Cookie(String, String)

Zdroj:

Cookie.cs

Inicializuje novou instanci Cookie třídy se zadaným Name a 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)

Parametry

name

String

Název Cookie. Následující znaky nesmí být použity uvnitř name: rovnítko, středník, čárka, nový řádek (\n), return (\r), tabulátor (\t) a znak mezery. Znak znaku dolaru ("$") nemůže být prvním znakem.

value

String

Hodnota Cookie. Následující znaky nesmí být použity uvnitř value: středník, čárka.

Výjimky

CookieException

Parametr name je null.

nebo

Parametr name má nulovou délku.

nebo

Parametr name obsahuje neplatný znak.

nebo

Parametr value je null .

-Nebo-

Parametr value obsahuje řetězec, který není uzavřený v uvozovkách, který obsahuje neplatný znak.

Poznámky

Výchozí hodnota parametru value používá prázdný řetězec ("").

Parametr value nesmí Cookie být null odkazem (Nothing v jazyce Visual Basic). Znaky středníku (";") a čárky (",") jsou vyhrazeny a nelze je předat v parametru value , pokud není řetězec předaný v parametru value uzavřen v dvojitých uvozovkách. Následující příklad konstruktoru by tedy byl úspěšný, ale při pokusu CookieContainer o přidání do Cookie instance s metodami Add(Cookie)Add(Uri, Cookie) operace selže a vyvolá výjimku:

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

Následující konstruktor s těmito speciálními znaky řídicími znaky však vytvoří Cookie , který lze přidat do CookieContainer instance:

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

Znak čárky se používá jako oddělovač mezi samostatnými soubory cookie na stejném řádku.

Viz také

• CookieCollection
• CookieContainer
• CookieException

Cookie(String, String, String)

Zdroj:

Cookie.cs

Inicializuje novou instanci Cookie třídy se zadaným Name, Valuea 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)

Parametry

name

String

Název Cookie. Následující znaky nesmí být použity uvnitř name: rovnítko, středník, čárka, nový řádek (\n), return (\r), tabulátor (\t) a znak mezery. Znak znaku dolaru ("$") nemůže být prvním znakem.

value

String

Hodnota Cookie. Následující znaky nesmí být použity uvnitř value: středník, čárka.

path

String

Podmnožina identifikátorů URI na zdrojovém serveru, na který se to Cookie vztahuje. Výchozí hodnota je /.

Výjimky

CookieException

Parametr name je null.

nebo

Parametr name má nulovou délku.

nebo

Parametr name obsahuje neplatný znak.

nebo

Parametr value je null .

-Nebo-

Parametr value obsahuje řetězec, který není uzavřený v uvozovkách, který obsahuje neplatný znak.

Poznámky

Výchozí hodnota parametru path používá prázdný řetězec ("").

Parametr value nesmí Cookie být null odkazem (Nothing v jazyce Visual Basic). Znaky středníku (";") a čárky (",") jsou vyhrazeny a nelze je předat v parametru value , pokud není řetězec předaný v parametru value uzavřen v dvojitých uvozovkách. Následující příklad konstruktoru by tedy byl úspěšný, ale při pokusu CookieContainer o přidání do Cookie instance s metodami Add(Cookie)Add(Uri, Cookie) operace selže a vyvolá výjimku:

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

Následující konstruktor s těmito speciálními znaky řídicími znaky však vytvoří Cookie , který lze přidat do CookieContainer instance:

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

Znak čárky se používá jako oddělovač mezi samostatnými soubory cookie na stejném řádku.

Viz také

• CookieCollection
• CookieContainer
• CookieException

Cookie(String, String, String, String)

Zdroj:

Cookie.cs

Inicializuje novou instanci Cookie třídy se zadaným Name, Value, Patha 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)

Parametry

name

String

Název Cookie. Následující znaky nesmí být použity uvnitř name: rovnítko, středník, čárka, nový řádek (\n), return (\r), tabulátor (\t) a znak mezery. Znak znaku dolaru ("$") nemůže být prvním znakem.

value

String

Hodnota objektu Cookie . Následující znaky nesmí být použity uvnitř value: středník, čárka.

path

String

Podmnožina identifikátorů URI na zdrojovém serveru, na který se to Cookie vztahuje. Výchozí hodnota je /.

domain

String

Volitelná internetová doména, pro kterou je tato Cookie doména platná. Výchozí hodnota je hostitel Cookie , ze které byl přijat.

Výjimky

CookieException

Parametr name je null.

nebo

Parametr name má nulovou délku.

nebo

Parametr name obsahuje neplatný znak.

nebo

Parametr value je null .

-Nebo-

Parametr value obsahuje řetězec, který není uzavřený v uvozovkách, který obsahuje neplatný znak.

Poznámky

Výchozí hodnota pro parametry domain a path používá prázdný řetězec ("").

Parametr value nesmí Cookie být null odkazem (Nothing v jazyce Visual Basic). Znaky středníku (";") a čárky (",") jsou vyhrazeny a nelze je předat v parametru value , pokud není řetězec předaný v parametru value uzavřen v dvojitých uvozovkách. Následující příklad konstruktoru by tedy byl úspěšný, ale při pokusu CookieContainer o přidání do Cookie instance s metodami Add(Cookie)Add(Uri, Cookie) operace selže a vyvolá výjimku:

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

Následující konstruktor s těmito speciálními znaky řídicími znaky však vytvoří Cookie , který lze přidat do CookieContainer instance:

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

Znak čárky se používá jako oddělovač mezi samostatnými soubory cookie na stejném řádku.

Viz také

• CookieCollection
• CookieContainer
• CookieException