Partilhar via


CookieHandler.Write Método

Definição

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 -> unit
Public 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 -> unit
Public 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 -> unit
Public 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 -> 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)

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