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 -> unit
Public Sub Write (value As Byte(), isPersistent As Boolean, tokenExpirationTime As DateTime)
Параметры
- value
- Byte[]
Значение файла cookie.
- isPersistent
- Boolean
true Значение файла cookie, если файл cookie является постоянным; false Если файл cookie доступен только для сеанса, то есть только до закрытия браузера на клиенте.
- tokenExpirationTime
- DateTime
Время окончания срока действия базового маркера.
Исключения
value имеет null или пуст.
Комментарии
isPersistent Если параметр имеет значениеfalse, для параметра задано DateTime.MinValueвремя окончания срока действия файла cookie.
isPersistent Если параметр имеет trueзначение, время окончания срока действия файла cookie задается PersistentSessionLifetime значением свойства, если это свойство не null так или, если PersistentSessionLifetime это свойствоnull, то время окончания срока действия задается значением tokenExpirationTime параметра.
Имя файла cookie, домен и путь задаются свойствами и Path свойствами.NameDomain Запрос задается .Current Указывает ли файл cookie только по протоколу SSLRequireSsl, а файл 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 (только для сеанса).
Исключения
value имеет null или пуст.
name имеет null или пуст.
Комментарии
Домен и путь файла cookie задаются свойствами и Path свойствамиDomain. Запрос задается .HttpContext.Current Запрос задается .Current Указывает ли файл cookie только по протоколу SSLRequireSsl, а файл 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 .
Исключения
value имеет null или пуст.
name имеет null или пуст.
Комментарии
Домен и путь файла cookie задаются свойствами и Path свойствамиDomain. Запрос задается .Current Указывает ли файл cookie только по протоколу SSLRequireSsl, а файл 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 Если файл cookie должен использоваться только для SSL-подключения; falseв противном случае .
- hideFromClientScript
- Boolean
true Значение , если файл cookie должен быть скрыт от клиентского скрипта; falseв противном случае .
- context
- HttpContext
Запрос HttpContext .
Исключения
value имеет null или пуст.
name имеет null или пуст.