Cookie Конструкторы

  • Ссылка

Определение

Пространство имен:
System.Net
Сборка:
System.Net.Primitives.dll
Сборка:
System.dll
Сборка:
netstandard.dll

Инициализирует новый экземпляр класса Cookie. В общем случае приложению не требуется конструировать класс Cookie, поскольку он создается автоматически на основе заголовка Set-Cookie, получаемого вместе с HTTP-ответом.

Перегрузки

Cookie()

Инициализирует новый экземпляр класса Cookie.
Cookie(String, String)

Инициализирует новый экземпляр класса Cookie с заданными объектами Name и Value.
Cookie(String, String, String)

Инициализирует новый экземпляр класса Cookie с заданными объектами Name, Value и Path.
Cookie(String, String, String, String)

Инициализирует новый экземпляр класса Cookie с заданными объектами Name, Value, Path и Domain.
Исходный код:
Cookie.cs
Исходный код:
Cookie.cs
Исходный код:
Cookie.cs

Инициализирует новый экземпляр класса Cookie.

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

Комментарии

Конструктор без параметров инициализирует все поля значениями по умолчанию, используя пустые строки ("") для name, value, pathи domain. Обратите внимание, что перед использованием экземпляра класса необходимо инициализировать Cookie по крайней мере Name свойство .

Применяется к

Исходный код:
Cookie.cs
Исходный код:
Cookie.cs
Исходный код:
Cookie.cs

Инициализирует новый экземпляр класса Cookie с заданными объектами Name и 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)

Параметры

name
String

Имя Cookie. Внутри name не должны использоваться следующие символы: знак равенства, точка с запятой, запятая, символ перехода на новую строку (\n), символ возврата каретки (\r), символ табуляции (\t) и пробел. Символ доллара ($) не может быть первым знаком.

value
String

Значение Cookie. Внутри value не должны использоваться следующие знаки: точка с запятой, запятая.

Исключения

CookieException

Параметр name имеет значение null.

-или-

Длина параметра name равна нулю.

-или-

Параметр name содержит недопустимый знак.

-или-

Параметр value имеет значение null.

-или-

Параметр value содержит строку, не заключенную в кавычки и содержащую недопустимый символ.

Комментарии

По умолчанию для value параметра используется пустая строка ("").

Параметр value для Cookie не должен быть ссылкой null (Nothing в Visual Basic). Символы точки с запятой (";") и запятой (",") зарезервированы и не могут быть переданы в value параметре, если строка, переданная в параметре value , не заключена в двойные кавычки. Таким образом, следующий пример конструктора будет успешным, но при попытке добавить его Cookie в CookieContainer экземпляр с помощью Add(Cookie) методов или Add(Uri, Cookie) операция завершится ошибкой и вызовет исключение:

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

Однако следующий конструктор с этими специальными символами, экранируемыми, создаст Cookie объект , который можно добавить в CookieContainer экземпляр :

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

Символ запятой используется в качестве разделителя между отдельными файлами cookie в одной строке.

См. также раздел

Применяется к

Исходный код:
Cookie.cs
Исходный код:
Cookie.cs
Исходный код:
Cookie.cs

Инициализирует новый экземпляр класса Cookie с заданными объектами Name, Value и 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)

Параметры

name
String

Имя Cookie. Внутри name не должны использоваться следующие символы: знак равенства, точка с запятой, запятая, символ перехода на новую строку (\n), символ возврата каретки (\r), символ табуляции (\t) и пробел. Символ доллара ($) не может быть первым знаком.

value
String

Значение Cookie. Внутри value не должны использоваться следующие знаки: точка с запятой, запятая.

path
String

Подмножество URI на исходном сервере, к которому применяется Cookie. Значение по умолчанию — "/".

Исключения

CookieException

Параметр name имеет значение null.

-или-

Длина параметра name равна нулю.

-или-

Параметр name содержит недопустимый знак.

-или-

Параметр value имеет значение null.

-или-

Параметр value содержит строку, не заключенную в кавычки и содержащую недопустимый символ.

Комментарии

По умолчанию для path параметра используется пустая строка ("").

Параметр value для Cookie не должен быть ссылкой null (Nothing в Visual Basic). Символы точки с запятой (";") и запятой (",") зарезервированы и не могут быть переданы в value параметре, если строка, переданная в параметре value , не заключена в двойные кавычки. Таким образом, следующий пример конструктора будет успешным, но при попытке добавить его Cookie в CookieContainer экземпляр с помощью Add(Cookie) методов или Add(Uri, Cookie) операция завершится ошибкой и вызовет исключение:

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

Однако следующий конструктор с этими специальными символами, экранируемыми, создаст Cookie объект , который можно добавить в CookieContainer экземпляр :

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

Символ запятой используется в качестве разделителя между отдельными файлами cookie в одной строке.

См. также раздел

Применяется к

Исходный код:
Cookie.cs
Исходный код:
Cookie.cs
Исходный код:
Cookie.cs

Инициализирует новый экземпляр класса Cookie с заданными объектами Name, Value, Path и 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)

Параметры

name
String

Имя Cookie. Внутри name не должны использоваться следующие символы: знак равенства, точка с запятой, запятая, символ перехода на новую строку (\n), символ возврата каретки (\r), символ табуляции (\t) и пробел. Символ доллара ($) не может быть первым знаком.

value
String

Значение объекта Cookie. Внутри value не должны использоваться следующие знаки: точка с запятой, запятая.

path
String

Подмножество URI на исходном сервере, к которому применяется Cookie. Значение по умолчанию — "/".

domain
String

Дополнительный интернет-домен, для которого действует этот Cookie. Значением по умолчанию является узел, с которого получен этот объект Cookie.

Исключения

CookieException

Параметр name имеет значение null.

-или-

Длина параметра name равна нулю.

-или-

Параметр name содержит недопустимый знак.

-или-

Параметр value имеет значение null.

-или-

Параметр value содержит строку, не заключенную в кавычки и содержащую недопустимый символ.

Комментарии

По умолчанию для domain параметров и path используется пустая строка ("").

Параметр value для Cookie не должен быть ссылкой null (Nothing в Visual Basic). Символы точки с запятой (";") и запятой (",") зарезервированы и не могут быть переданы в value параметре, если строка, переданная в параметре value , не заключена в двойные кавычки. Таким образом, следующий пример конструктора будет успешным, но при попытке добавить его Cookie в CookieContainer экземпляр с помощью Add(Cookie) методов или Add(Uri, Cookie) операция завершится ошибкой и вызовет исключение:

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

Однако следующий конструктор с этими специальными символами, экранируемыми, создаст Cookie объект , который можно добавить в CookieContainer экземпляр :

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

Символ запятой используется в качестве разделителя между отдельными файлами cookie в одной строке.

См. также раздел

Применяется к