CookieHandler.Write Método

Definição

Espaço de Nomes:: System.IdentityModel.Services

Assemblagem:: System.IdentityModel.Services.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Escreve um biscoito.

Sobrecargas

Name	Description
Write(Byte[], Boolean, DateTime)	Escreve um cookie associado ao pedido atual que tem o valor, persistência e tempo de expiração especificados.
Write(Byte[], String, DateTime)	Escreve um cookie associado ao pedido atual com o nome, valor e tempo de expiração especificados.
Write(Byte[], String, DateTime, HttpContext)	Escreve um cookie associado ao pedido especificado que tem o nome, valor e tempo de expiração especificados.
Write(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)	Escreve um cookie associado ao pedido especificado que tem o nome, valor, domínio, caminho, tempo de expiração e visibilidade especificados.

Write(Byte[], Boolean, DateTime)

Escreve um cookie associado ao pedido atual que tem o valor, persistência e 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 -> unit

Public Sub Write (value As Byte(), isPersistent As Boolean, tokenExpirationTime As DateTime)

Parâmetros

value: Byte[]

O valor das bolachas.

isPersistent: Boolean

true se o cookie for persistente; false Se o cookie for apenas para sessão, ou seja, válido apenas até o navegador do cliente estar fechado.

tokenExpirationTime: DateTime

O tempo de expiração do token subjacente.

Exceções

ArgumentNullException

value é null ou vazia.

Observações

Se o isPersistent parâmetro for false, o tempo de expiração do cookie é definido para DateTime.MinValue. Se o isPersistent parâmetro for true, o tempo de expiração do cookie é definido para o valor da PersistentSessionLifetime propriedade se não null for ou, se a PersistentSessionLifetime propriedade for null, o tempo de expiração é definido para o valor do tokenExpirationTime parâmetro.

O nome do cookie, domínio e caminho são especificados pelas Namepropriedades , Domain, e Path . O pedido é especificado por Current. Se o cookie deve ser enviado apenas por SSL é especificado pela RequireSsl propriedade e se o cookie deve ser oculto dos scripts do lado do cliente é especificado pela HideFromClientScript propriedade.

Aplica-se a

Write(Byte[], String, DateTime)

Escreve um cookie associado ao pedido atual com o nome, valor e tempo 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 das bolachas.

name: String

O nome da bolacha.

expirationTime: DateTime

O tempo de expiração do cookie, ou DateTime.MinValue para um cookie de sessão (apenas sessão).

Exceções

ArgumentNullException

value é null ou vazia.

ArgumentException

name é null ou vazia.

Observações

O domínio e o caminho dos cookies são especificados pelas Domain propriedades e.Path O pedido é especificado por HttpContext.Current. O pedido é especificado por Current. Se o cookie deve ser enviado apenas por SSL é especificado pela RequireSsl propriedade e se o cookie deve ser oculto dos scripts do lado do cliente é especificado pela HideFromClientScript propriedade.

Aplica-se a

Write(Byte[], String, DateTime, HttpContext)

Escreve um cookie associado ao pedido especificado que tem o nome, valor e tempo 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 das bolachas.

name: String

O nome da bolacha.

expirationTime: DateTime

O tempo de expiração do cookie, ou DateTime.MinValue para um cookie de sessão (apenas sessão).

context: HttpContext

O HttpContext para o pedido.

Exceções

ArgumentNullException

value é null ou vazia.

ArgumentException

name é null ou vazia.

Observações

O domínio e o caminho dos cookies são especificados pelas Domain propriedades e.Path O pedido é especificado por Current. Se o cookie deve ser enviado apenas por SSL é especificado pela RequireSsl propriedade e se o cookie deve ser oculto dos scripts do lado do cliente é especificado pela HideFromClientScript propriedade.

Aplica-se a

Write(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)

Escreve um cookie associado ao pedido especificado que tem o nome, valor, domínio, caminho, tempo de expiração e 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 das bolachas.

name: String

O nome da bolacha.

path: String

O caminho para a bolacha.

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 (apenas sessão).

requiresSsl: Boolean

true se o cookie só deveria ser usado através de uma ligaçã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 o pedido.

Exceções

ArgumentNullException

value é null ou vazia.

ArgumentException

name é null ou vazia.

Aplica-se a

Comentários

Esta página foi útil?