Sdílet prostřednictvím

Cookie Konstruktory

  • Reference

Definice

Obor názvů:
System.Net
Sestavení:
System.Net.Primitives.dll
Sestavení:
System.dll
Sestavení:
netstandard.dll

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

Přetížení

Cookie()

Inicializuje novou instanci Cookie třídy.
Cookie(String, String)

Inicializuje novou instanci Cookie třídy se zadanými Name a Value.
Cookie(String, String, String)

Inicializuje novou instanci Cookie třídy se zadanými Name, Valuea Path.
Cookie(String, String, String, String)

Inicializuje novou instanci Cookie třídy se zadanými Name, Value, Patha Domain.
Zdroj:
Cookie.cs
Zdroj:
Cookie.cs
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. Všimněte si, že alespoň Name vlastnost musí být inicializována před použitím instance Cookie třídy.

Platí pro

Zdroj:
Cookie.cs
Zdroj:
Cookie.cs
Zdroj:
Cookie.cs

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

Parametry

name
String

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

value
String

Hodnota Cookie. Uvnitř nesmí být použity valuenásledující znaky: 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 a obsahuje neplatný znak.

Poznámky

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

Parametr value pro Cookie nesmí být odkaz ( null Nothing v jazyce Visual Basic). Znaky středníku (";") a čárky (",") jsou vyhrazeny a nelze je předat v parametru value , pokud řetězec předaný v parametru value není uzavřen do dvojitých uvozovek. Následující příklad konstruktoru by tedy proběhl úspěšně, ale když se ho Cookie pokusíte přidat do CookieContainer instance pomocí Add(Cookie) metod nebo 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 s řídicími Cookie znaky však vytvoří objekt, 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é

Platí pro

Zdroj:
Cookie.cs
Zdroj:
Cookie.cs
Zdroj:
Cookie.cs

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

Parametry

name
String

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

value
String

Hodnota Cookie. Uvnitř nesmí být použity valuenásledující znaky: 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 a obsahuje neplatný znak.

Poznámky

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

Parametr value pro Cookie nesmí být odkaz ( null Nothing v jazyce Visual Basic). Znaky středníku (";") a čárky (",") jsou vyhrazeny a nelze je předat v parametru value , pokud řetězec předaný v parametru value není uzavřen do dvojitých uvozovek. Následující příklad konstruktoru by tedy proběhl úspěšně, ale když se ho Cookie pokusíte přidat do CookieContainer instance pomocí Add(Cookie) metod nebo 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 s řídicími Cookie znaky však vytvoří objekt, 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é

Platí pro

Zdroj:
Cookie.cs
Zdroj:
Cookie.cs
Zdroj:
Cookie.cs

Inicializuje novou instanci Cookie třídy se zadanými 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);
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 Uvnitř nesmí být použity namenásledující znaky: rovnítko, středník, čárka, nový řádek (\n), návrat (\r), tabulátor (\t) a znak mezery. Znak dolaru ("$") nemůže být prvním znakem.

value
String

Hodnota objektu Cookie . Uvnitř nesmí být použity valuenásledující znaky: 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 a obsahuje neplatný znak.

Poznámky

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

Parametr value pro Cookie nesmí být odkaz ( null Nothing v jazyce Visual Basic). Znaky středníku (";") a čárky (",") jsou vyhrazeny a nelze je předat v parametru value , pokud řetězec předaný v parametru value není uzavřen do dvojitých uvozovek. Následující příklad konstruktoru by tedy proběhl úspěšně, ale když se ho Cookie pokusíte přidat do CookieContainer instance pomocí Add(Cookie) metod nebo 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 s řídicími Cookie znaky však vytvoří objekt, 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é

Platí pro