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), return (\r), tab (\t) и пробел. Символ знака доллара ("$") не может быть первым символом.

value
String

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

Исключения

CookieException

Параметр namenull.

-или-

Параметр 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), return (\r), tab (\t) и пробел. Символ знака доллара ("$") не может быть первым символом.

value
String

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

path
String

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

Исключения

CookieException

Параметр namenull.

-или-

Параметр 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), return (\r), tab (\t) и пробел. Символ знака доллара ("$") не может быть первым символом.

value
String

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

path
String

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

domain
String

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

Исключения

CookieException

Параметр namenull.

-или-

Параметр 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 в одной строке.

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

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