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
| Write(Byte[], Boolean, DateTime) |
Grava um cookie associado à solicitação atual que tem o valor, a persistência e a hora 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, a hora 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 a hora 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 é persistente; false se o cookie é somente de 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 é null ou 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 do cookie, o domínio e o Namecaminho são especificados pelas propriedades , Domaine Path . A solicitação é especificada por Current. Se o cookie deve ser enviado somente 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
O tempo de expiração do cookie ou DateTime.MinValue para um cookie de sessão (somente sessão).
Exceções
value é null ou vazio.
name é null ou vazio.
Comentários
O domínio e o caminho do Domain cookie são especificados pelas propriedades e Path . A solicitação é especificada por HttpContext.Current. A solicitação é especificada por Current. Se o cookie deve ser enviado somente 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
O tempo 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 é null ou vazio.
name é null ou vazio.
Comentários
O domínio e o caminho do Domain cookie são especificados pelas propriedades e Path . A solicitação é especificada por Current. Se o cookie deve ser enviado somente 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, a hora 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
O tempo de expiração do cookie ou DateTime.MinValue para um cookie de sessão (somente sessão).
- requiresSsl
- Boolean
true se o cookie precisar ser usado apenas em uma conexão SSL; caso contrário, false.
- hideFromClientScript
- Boolean
true se o cookie precisar ser ocultado do script de cliente; caso contrário, false.
- context
- HttpContext
O HttpContext para a solicitação.
Exceções
value é null ou vazio.
name é null ou vazio.
Aplica-se a
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de