CookieHandler.Write Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Записывает файл 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 -> unitPublic Sub Write (value As Byte(), isPersistent As Boolean, tokenExpirationTime As DateTime)Параметры
- value
- Byte[]
Значение файла Cookie.
- isPersistent
- Boolean
значение true, если файлы cookie сохраняются; значение false, если файлы cookie только для сеанса, т. е. являются допустимыми только до тех пор пока браузер на клиенте не закрыт.
- tokenExpirationTime
- DateTime
Время окончания действия базового токена.
Исключения
Параметр 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 -> unitPublic Sub Write (value As Byte(), name As String, expirationTime As DateTime)Параметры
- value
- Byte[]
Значение файла Cookie.
- name
- String
Имя файла cookie.
- expirationTime
- DateTime
Время окончания срока действия файла cookie или DateTime.MinValue для файла cookie сеанса (только для сеанса).
Исключения
Параметр value имеет значение null или пуст.
Параметр 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 -> unitPublic 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 для запроса.
Исключения
Параметр value имеет значение null или пуст.
Параметр 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 -> unitPublic 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 для запроса.
Исключения
Параметр value имеет значение null или пуст.
Параметр name имеет значение null или пуст.
