CookieHandler.Write Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Grava um cookie.
Sobrecargas
| Nome | Description |
|---|---|
| Write(Byte[], Boolean, DateTime) |
Grava um cookie associado à solicitação atual que tem o valor, a persistência e o tempo de expiração especificados. |
| Write(Byte[], String, DateTime) |
Grava um cookie associado à solicitação atual que tem o nome, o valor e a hora de expiração especificados. |
| Write(Byte[], String, DateTime, HttpContext) |
Grava um cookie associado à solicitação especificada que tem o nome, o valor e a hora de expiração especificados. |
| Write(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext) |
Grava um cookie associado à solicitação especificada que tem o nome, o valor, o domínio, o caminho, o tempo de expiração e a visibilidade especificados. |
Write(Byte[], Boolean, DateTime)
Grava um cookie associado à solicitação atual que tem o valor, a persistência e o tempo de expiração especificados.
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)Parâmetros
- value
- Byte[]
O valor do cookie.
- isPersistent
- Boolean
true se o cookie for persistente; false se o cookie for somente sessão, ou seja, válido apenas até que o navegador no cliente seja fechado.
- tokenExpirationTime
- DateTime
O tempo de expiração do token subjacente.
Exceções
value está null ou está vazio.
Comentários
Se o isPersistent parâmetro for false, o tempo de expiração do cookie será definido como DateTime.MinValue. Se o isPersistent parâmetro for true, o tempo de expiração do cookie será definido como o valor da PersistentSessionLifetime propriedade se não null for ou, se a PersistentSessionLifetime propriedade for null, o tempo de expiração será definido como o valor do tokenExpirationTime parâmetro.
O nome, o domínio e o caminho do Namecookie são especificados pelo , Domaine Path propriedades. A solicitação é especificada por Current. Se o cookie deve ser enviado apenas por SSL é especificado pela RequireSsl propriedade e se o cookie deve ser oculto de scripts do lado do cliente é especificado pela HideFromClientScript propriedade.
Aplica-se a
Write(Byte[], String, DateTime)
Grava um cookie associado à solicitação atual que tem o nome, o valor e a hora de expiração especificados.
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)Parâmetros
- value
- Byte[]
O valor do cookie.
- name
- String
O nome do cookie.
- expirationTime
- DateTime
A hora de expiração do cookie ou DateTime.MinValue para um cookie de sessão (somente sessão).
Exceções
value está null ou está vazio.
name está null ou está vazio.
Comentários
O domínio e o caminho do Domain cookie são especificados pelo e Path pelas propriedades. A solicitação é especificada por HttpContext.Current. A solicitação é especificada por Current. Se o cookie deve ser enviado apenas por SSL é especificado pela RequireSsl propriedade e se o cookie deve ser oculto de scripts do lado do cliente é especificado pela HideFromClientScript propriedade.
Aplica-se a
Write(Byte[], String, DateTime, HttpContext)
Grava um cookie associado à solicitação especificada que tem o nome, o valor e a hora de expiração especificados.
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)Parâmetros
- value
- Byte[]
O valor do cookie.
- name
- String
O nome do cookie.
- expirationTime
- DateTime
A hora de expiração do cookie ou DateTime.MinValue para um cookie de sessão (somente sessão).
- context
- HttpContext
O HttpContext para a solicitação.
Exceções
value está null ou está vazio.
name está null ou está vazio.
Comentários
O domínio e o caminho do Domain cookie são especificados pelo e Path pelas propriedades. A solicitação é especificada por Current. Se o cookie deve ser enviado apenas por SSL é especificado pela RequireSsl propriedade e se o cookie deve ser oculto de scripts do lado do cliente é especificado pela HideFromClientScript propriedade.
Aplica-se a
Write(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)
Grava um cookie associado à solicitação especificada que tem o nome, o valor, o domínio, o caminho, o tempo de expiração e a visibilidade especificados.
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)Parâmetros
- value
- Byte[]
O valor do cookie.
- name
- String
O nome do cookie.
- path
- String
O caminho para o cookie.
- domain
- String
O domínio do cookie.
- expirationTime
- DateTime
A hora de expiração do cookie ou DateTime.MinValue para um cookie de sessão (somente sessão).
- requiresSsl
- Boolean
true se o cookie só deve ser usado em uma conexão SSL; caso contrário, false.
- hideFromClientScript
- Boolean
true se o cookie deve estar oculto do script do cliente; caso contrário, false.
- context
- HttpContext
O HttpContext para a solicitação.
Exceções
value está null ou está vazio.
name está null ou está vazio.
