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

Определение

Пространство имен:
System.Net
Сборки:
System.dll, System.Net.Primitives.dll
Сборки:
netstandard.dll, System.Net.Primitives.dll
Сборка:
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.cs
Исходный код:
Cookie.cs

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

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

Комментарии

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

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

Исходный код:
Cookie.cs
Исходный код:
Cookie.cs
Исходный код:
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

Параметр 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.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

Параметр 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.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

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

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

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