Cookie Konstruktory

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.Primitives.dll

Inicjuje nowe wystąpienie klasy Cookie. Ogólnie rzecz biorąc, aplikacja nie musi konstruować Cookie klasy, ponieważ jest tworzona automatycznie na podstawie nagłówka Set-Cookie odebranego z odpowiedzią HTTP.

Przeciążenia

Cookie()	Inicjuje nowe wystąpienie klasy Cookie.
Cookie(String, String)	Inicjuje Cookie nowe wystąpienie klasy o określonej wartości Name i Value.
Cookie(String, String, String)	Inicjuje Cookie nowe wystąpienie klasy o określonej wartości Name, Valuei Path.
Cookie(String, String, String, String)	Inicjuje Cookie nowe wystąpienie klasy o określonej wartości Name, , ValuePathi Domain.

Cookie()

Źródło:

Cookie.cs

Inicjuje nowe wystąpienie klasy Cookie.

public:
 Cookie();

public Cookie ();

Public Sub New ()

Uwagi

Konstruktor bez parametrów inicjuje wszystkie pola do wartości domyślnych, używając pustych ciągów ("") dla name, , value, pathi domain. Należy pamiętać, że przed użyciem wystąpienia Cookie klasy należy zainicjować co najmniej Name właściwość.

Cookie(String, String)

Źródło:

Cookie.cs

Inicjuje Cookie nowe wystąpienie klasy o określonej wartości Name i 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

Nazwa elementu Cookie. Następujące znaki nie mogą być używane wewnątrz nameznaku równości, średnika, przecinka, nowego wiersza (\n), powrotu (\r), karty (\t) i znaku spacji. Znak dolara ("$") nie może być pierwszym znakiem.

value

String

Wartość elementu Cookie. Następujące znaki nie mogą być używane wewnątrz value: średnik, przecinek.

Wyjątki

CookieException

Parametr name to null.

-lub-

Parametr name ma zerową długość.

-lub-

Parametr name zawiera nieprawidłowy znak.

-lub-

Parametr value to null .

-Lub-

Parametr value zawiera ciąg, który nie znajduje się w cudzysłowie, który zawiera nieprawidłowy znak.

Uwagi

Wartość domyślna parametru value używa pustego ciągu ("").

Parametr value elementu Cookie nie może być odwołaniem null (Nic w Visual Basic). Średnik (";") i przecinek (",") są zastrzeżone i nie można przekazać w parametrze value , chyba że ciąg przekazany w parametrze value jest ujęta w cudzysłowy. W związku z tym następujący przykładowy konstruktor powiedzie się, ale podczas próby dodania go Cookie do wystąpienia przy Add(Cookie) użyciu metod lub Add(Uri, Cookie) operacja zakończy się niepowodzeniem CookieContainer i zgłosi wyjątek:

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

Jednak następujący konstruktor z tymi znakami specjalnymi zostanie utworzony Cookie element, który można dodać do CookieContainer wystąpienia:

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

Znak przecinka jest używany jako ogranicznik między oddzielnymi plikami cookie w tym samym wierszu.

Zobacz też

• CookieCollection
• CookieContainer
• CookieException

Cookie(String, String, String)

Źródło:

Cookie.cs

Inicjuje Cookie nowe wystąpienie klasy o określonej wartości Name, Valuei 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

Nazwa elementu Cookie. Następujące znaki nie mogą być używane wewnątrz nameznaku równości, średnika, przecinka, nowego wiersza (\n), powrotu (\r), karty (\t) i znaku spacji. Znak dolara ("$") nie może być pierwszym znakiem.

value

String

Wartość elementu Cookie. Następujące znaki nie mogą być używane wewnątrz value: średnik, przecinek.

path

String

Podzestaw identyfikatorów URI na serwerze źródłowym, do którego ma to Cookie zastosowanie. Wartość domyślna to "/".

Wyjątki

CookieException

Parametr name to null.

-lub-

Parametr name ma zerową długość.

-lub-

Parametr name zawiera nieprawidłowy znak.

-lub-

Parametr value to null .

-Lub-

Parametr value zawiera ciąg, który nie znajduje się w cudzysłowie, który zawiera nieprawidłowy znak.

Uwagi

Wartość domyślna parametru path używa pustego ciągu ("").

Parametr value elementu Cookie nie może być odwołaniem null (Nic w Visual Basic). Średnik (";") i przecinek (",") są zastrzeżone i nie można przekazać w parametrze value , chyba że ciąg przekazany w parametrze value jest ujęta w cudzysłowy. W związku z tym następujący przykładowy konstruktor powiedzie się, ale podczas próby dodania go Cookie do wystąpienia przy Add(Cookie) użyciu metod lub Add(Uri, Cookie) operacja zakończy się niepowodzeniem CookieContainer i zgłosi wyjątek:

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

Jednak następujący konstruktor z tymi znakami specjalnymi zostanie utworzony Cookie element, który można dodać do CookieContainer wystąpienia:

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

Znak przecinka jest używany jako ogranicznik między oddzielnymi plikami cookie w tym samym wierszu.

Zobacz też

• CookieCollection
• CookieContainer
• CookieException

Cookie(String, String, String, String)

Źródło:

Cookie.cs

Inicjuje Cookie nowe wystąpienie klasy o określonej wartości Name, , ValuePathi 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

Nazwa elementu Cookie. Następujące znaki nie mogą być używane wewnątrz nameznaku równości, średnika, przecinka, nowego wiersza (\n), powrotu (\r), karty (\t) i znaku spacji. Znak dolara ("$") nie może być pierwszym znakiem.

value

String

Wartość Cookie obiektu. Następujące znaki nie mogą być używane wewnątrz value: średnik, przecinek.

path

String

Podzestaw identyfikatorów URI na serwerze źródłowym, do którego ma to Cookie zastosowanie. Wartość domyślna to "/".

domain

String

Opcjonalna domena internetowa, dla której jest to Cookie prawidłowe. Wartość domyślna to host Cookie , z poziomu który został odebrany.

Wyjątki

CookieException

Parametr name to null.

-lub-

Parametr name ma zerową długość.

-lub-

Parametr name zawiera nieprawidłowy znak.

-lub-

Parametr value to null .

-Lub-

Parametr value zawiera ciąg, który nie znajduje się w cudzysłowie, który zawiera nieprawidłowy znak.

Uwagi

Wartość domyślna parametrów domain i path używa pustego ciągu ("").

Parametr value elementu Cookie nie może być odwołaniem null (Nic w Visual Basic). Średnik (";") i przecinek (",") są zastrzeżone i nie można przekazać w parametrze value , chyba że ciąg przekazany w parametrze value jest ujęta w cudzysłowy. W związku z tym następujący przykładowy konstruktor powiedzie się, ale podczas próby dodania go Cookie do wystąpienia przy Add(Cookie) użyciu metod lub Add(Uri, Cookie) operacja zakończy się niepowodzeniem CookieContainer i zgłosi wyjątek:

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

Jednak następujący konstruktor z tymi znakami specjalnymi zostanie utworzony Cookie element, który można dodać do CookieContainer wystąpienia:

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

Znak przecinka jest używany jako ogranicznik między oddzielnymi plikami cookie w tym samym wierszu.

Zobacz też

• CookieCollection
• CookieContainer
• CookieException