CookieHandler.Write Método

Definição

Namespace:

System.IdentityModel.Services

Assembly:

System.IdentityModel.Services.dll

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

ArgumentNullException

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 .

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

ArgumentNullException

value é null ou vazio.

ArgumentException

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 .

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

ArgumentNullException

value é null ou vazio.

ArgumentException

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 .

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

ArgumentNullException

value é null ou vazio.

ArgumentException

name é null ou vazio.