CookieHandler.Write Метод

Определение

Пространство имен:

System.IdentityModel.Services

Сборка:

System.IdentityModel.Services.dll

Записывает файл cookie.

Перегрузки

Write(Byte[], Boolean, DateTime)	Записывает связанный с текущим запросом файл cookie, имеющий заданные значение, сохраняемость и срок действия.
Write(Byte[], String, DateTime)	Записывает связанный с текущим запросом файл cookie, имеющий заданные имя, значение и срок действия.
Write(Byte[], String, DateTime, HttpContext)	Записывает связанный с указанным запросом файл cookie, имеющий заданные имя, значение и срок действия.
Write(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)	Записывает связанный с указанным запросом файл cookie, имеющий заданные имя, значение, домен, путь, срок действия и видимость.

Write(Byte[], Boolean, DateTime)

Записывает связанный с текущим запросом файл cookie, имеющий заданные значение, сохраняемость и срок действия.

public:
 void Write(cli::array <System::Byte> ^ value, bool isPersistent, DateTime tokenExpirationTime);

public void Write (byte[] value, bool isPersistent, DateTime tokenExpirationTime);

member this.Write : byte[] * bool * DateTime -> unit

Public Sub Write (value As Byte(), isPersistent As Boolean, tokenExpirationTime As DateTime)

Параметры

value

Byte[]

Значение файла Cookie.

isPersistent

Boolean

значение true, если файлы cookie сохраняются; значение false, если файлы cookie только для сеанса, т. е. являются допустимыми только до тех пор пока браузер на клиенте не закрыт.

tokenExpirationTime

DateTime

Время окончания действия базового токена.

Исключения

ArgumentNullException

Параметр value имеет значение null или пуст.

Комментарии

isPersistent Если параметр имеет значение false, для срока действия файла cookie устанавливается значение DateTime.MinValue. isPersistent Если параметр имеет значение true, то в качестве времени окончания срока действия файла cookie устанавливается значение PersistentSessionLifetime свойства , если оно не null равно, или, если PersistentSessionLifetime свойство имеет значение null, время окончания срока действия устанавливается в значение tokenExpirationTime параметра .

Имя файла cookie, домен и путь задаются свойствами Name, Domainи Path . Запрос задается параметром Current. Указывает, должен ли файл cookie отправляться RequireSsl только по протоколу SSL, свойство указывает, должен ли файл cookie быть скрыт от клиентских скриптов, определяется свойством HideFromClientScript .

Write(Byte[], String, DateTime)

Записывает связанный с текущим запросом файл cookie, имеющий заданные имя, значение и срок действия.

public:
 void Write(cli::array <System::Byte> ^ value, System::String ^ name, DateTime expirationTime);

public void Write (byte[] value, string name, DateTime expirationTime);

member this.Write : byte[] * string * DateTime -> unit

Public Sub Write (value As Byte(), name As String, expirationTime As DateTime)

Параметры

value

Byte[]

Значение файла Cookie.

name

String

Имя файла cookie.

expirationTime

DateTime

Время окончания срока действия файла cookie или DateTime.MinValue для файла cookie сеанса (только для сеанса).

Исключения

ArgumentNullException

Параметр value имеет значение null или пуст.

ArgumentException

Параметр name имеет значение null или пуст.

Комментарии

Домен и путь файла cookie задаются свойствами Domain и Path . Запрос задается параметром HttpContext.Current. Запрос задается параметром Current. Указывает, должен ли файл cookie отправляться RequireSsl только по протоколу SSL, свойство указывает, должен ли файл cookie быть скрыт от клиентских скриптов, определяется свойством HideFromClientScript .

Write(Byte[], String, DateTime, HttpContext)

Записывает связанный с указанным запросом файл cookie, имеющий заданные имя, значение и срок действия.

public:
 void Write(cli::array <System::Byte> ^ value, System::String ^ name, DateTime expirationTime, System::Web::HttpContext ^ context);

public void Write (byte[] value, string name, DateTime expirationTime, System.Web.HttpContext context);

member this.Write : byte[] * string * DateTime * System.Web.HttpContext -> unit

Public Sub Write (value As Byte(), name As String, expirationTime As DateTime, context As HttpContext)

Параметры

value

Byte[]

Значение файла Cookie.

name

String

Имя файла cookie.

expirationTime

DateTime

Время окончания срока действия файла cookie или DateTime.MinValue для файла cookie сеанса (только для сеанса).

context

HttpContext

HttpContext для запроса.

Исключения

ArgumentNullException

Параметр value имеет значение null или пуст.

ArgumentException

Параметр name имеет значение null или пуст.

Комментарии

Домен и путь файла cookie задаются свойствами Domain и Path . Запрос задается параметром Current. Указывает, должен ли файл cookie отправляться RequireSsl только по протоколу SSL, свойство указывает, должен ли файл cookie быть скрыт от клиентских скриптов, определяется свойством HideFromClientScript .

Write(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)

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

public:
 void Write(cli::array <System::Byte> ^ value, System::String ^ name, System::String ^ path, System::String ^ domain, DateTime expirationTime, bool requiresSsl, bool hideFromClientScript, System::Web::HttpContext ^ context);

public void Write (byte[] value, string name, string path, string domain, DateTime expirationTime, bool requiresSsl, bool hideFromClientScript, System.Web.HttpContext context);

member this.Write : byte[] * string * string * string * DateTime * bool * bool * System.Web.HttpContext -> unit

Public Sub Write (value As Byte(), name As String, path As String, domain As String, expirationTime As DateTime, requiresSsl As Boolean, hideFromClientScript As Boolean, context As HttpContext)

Параметры

value

Byte[]

Значение файла Cookie.

name

String

Имя файла cookie.

path

String

Путь к файлу cookie.

domain

String

Домен для файла cookie.

expirationTime

DateTime

Время окончания срока действия файла cookie или DateTime.MinValue для файла cookie сеанса (только для сеанса).

requiresSsl

Boolean

Значение true, если файл сookie должен использоваться только через SSL-соединение; в противном случае — значение false.

hideFromClientScript

Boolean

Значение true, если файл cookie должен быть скрыт от клиентских скриптов; в противном случае — значение false.

context

HttpContext

HttpContext для запроса.

Исключения

ArgumentNullException

Параметр value имеет значение null или пуст.

ArgumentException

Параметр name имеет значение null или пуст.