Cookie Konstruktory

Definicja

Przestrzeń nazw:

System.Net

Zestawy:

netstandard.dll, 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

Nazwa	Opis
Cookie()	Inicjuje nowe wystąpienie klasy Cookie.
Cookie(String, String)	Inicjuje Cookie nowe wystąpienie klasy o określonej Name wartości i Value.
Cookie(String, String, String)	Inicjuje nowe wystąpienie Cookie klasy z określonym Name, Valuei Path.
Cookie(String, String, String, String)	Inicjuje nowe wystąpienie Cookie klasy z określonym 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 przy użyciu pustych ciągów ("") dla name, , valuepathi domain. Należy pamiętać, że co najmniej Name właściwość musi zostać zainicjowana przed użyciem wystąpienia Cookie klasy.

Cookie(String, String)

Źródło:

Cookie.cs

Inicjuje Cookie nowe wystąpienie klasy o określonej Name wartości 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), return (\r), tabulatora (\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średnika, przecinka.

Wyjątki

CookieException

Parametr name jest 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 jest ujęta w cudzysłów, który zawiera nieprawidłowy znak.

Uwagi

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

Parametr value dla elementu Cookie nie może być odwołaniem null (Nic w Visual Basic). Średnik (";") i przecinek (",") są zastrzeżone i nie mogą być przekazywane 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 z metodami Add(Cookie) 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 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 nowe wystąpienie Cookie klasy z określonym 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), return (\r), tabulatora (\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średnika, przecinka.

path

String

Podzbiór identyfikatorów URI na serwerze pochodzenia, do którego ma to Cookie zastosowanie. Wartość domyślna to "/".

Wyjątki

CookieException

Parametr name jest 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 jest ujęta w cudzysłów, który zawiera nieprawidłowy znak.

Uwagi

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

Parametr value dla elementu Cookie nie może być odwołaniem null (Nic w Visual Basic). Średnik (";") i przecinek (",") są zastrzeżone i nie mogą być przekazywane 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 z metodami Add(Cookie) 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 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 nowe wystąpienie Cookie klasy z określonym 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), return (\r), tabulatora (\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średnika, przecinka.

path

String

Podzbiór identyfikatorów URI na serwerze pochodzenia, 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 który został odebrany.

Wyjątki

CookieException

Parametr name jest 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 jest ujęta w cudzysłów, który zawiera nieprawidłowy znak.

Uwagi

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

Parametr value dla elementu Cookie nie może być odwołaniem null (Nic w Visual Basic). Średnik (";") i przecinek (",") są zastrzeżone i nie mogą być przekazywane 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 z metodami Add(Cookie) 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 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