CookieHandler.Write Méthode

Définition

Espace de noms:

System.IdentityModel.Services

Assembly:

System.IdentityModel.Services.dll

Écrit un cookie.

Surcharges

Write(Byte[], Boolean, DateTime)	Écrit un cookie associé à la demande actuelle portant la valeur, la persistance et le délai d'expiration spécifiés.
Write(Byte[], String, DateTime)	Écrit un cookie associé à la demande actuelle portant le nom, la valeur et le délai d'expiration spécifiés.
Write(Byte[], String, DateTime, HttpContext)	Écrit un cookie associé à la demande spécifiée portant le nom, la valeur et le délai d'expiration spécifiés.
Write(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)	Écrit un cookie associé à la demande spécifiée portant le nom, la valeur, le domaine, le chemin d'accès, le délai d'expiration et la visibilité spécifiés.

Write(Byte[], Boolean, DateTime)

Écrit un cookie associé à la demande actuelle portant la valeur, la persistance et le délai d'expiration spécifiés.

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)

Paramètres

value

Byte[]

Valeur du cookie.

isPersistent

Boolean

true si le cookie est persistant ; false si le cookie est réservé à la session uniquement, autrement dit, uniquement valide jusqu'à ce que le navigateur du client est fermé.

tokenExpirationTime

DateTime

Heure d'expiration du jeton sous-jacent.

Exceptions

ArgumentNullException

value a la valeur null ou est vide.

Remarques

Si le isPersistent paramètre est false, le délai d’expiration du cookie est défini sur DateTime.MinValue. Si le isPersistent paramètre est true, le délai d’expiration du cookie est défini sur la valeur de la PersistentSessionLifetime propriété si ce n’est pas null le cas ou, si la PersistentSessionLifetime propriété est null, le délai d’expiration est défini sur la valeur du tokenExpirationTime paramètre .

Le nom du cookie, le domaine et le chemin d’accès sont spécifiés par les Namepropriétés , Domainet Path . La requête est spécifiée par Current. La propriété indique si le cookie doit être envoyé uniquement via RequireSsl SSL et si le cookie doit être masqué dans les scripts côté client est spécifié par la HideFromClientScript propriété .

Write(Byte[], String, DateTime)

Écrit un cookie associé à la demande actuelle portant le nom, la valeur et le délai d'expiration spécifiés.

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)

Paramètres

value

Byte[]

Valeur du cookie.

name

String

Nom du cookie.

expirationTime

DateTime

Heure d’expiration du cookie ou DateTime.MinValue pour un cookie de session (session uniquement).

Exceptions

ArgumentNullException

value a la valeur null ou est vide.

ArgumentException

name a la valeur null ou est vide.

Remarques

Le domaine et le chemin du cookie sont spécifiés par les Domain propriétés et Path . La requête est spécifiée par HttpContext.Current. La requête est spécifiée par Current. La propriété indique si le cookie doit être envoyé uniquement via RequireSsl SSL et si le cookie doit être masqué dans les scripts côté client est spécifié par la HideFromClientScript propriété .

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

Écrit un cookie associé à la demande spécifiée portant le nom, la valeur et le délai d'expiration spécifiés.

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)

Paramètres

value

Byte[]

Valeur du cookie.

name

String

Nom du cookie.

expirationTime

DateTime

Heure d’expiration du cookie ou DateTime.MinValue pour un cookie de session (session uniquement).

context

HttpContext

HttpContext de la requête.

Exceptions

ArgumentNullException

value a la valeur null ou est vide.

ArgumentException

name a la valeur null ou est vide.

Remarques

Le domaine et le chemin du cookie sont spécifiés par les Domain propriétés et Path . La requête est spécifiée par Current. La propriété indique si le cookie doit être envoyé uniquement via RequireSsl SSL et si le cookie doit être masqué dans les scripts côté client est spécifié par la HideFromClientScript propriété .

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

Écrit un cookie associé à la demande spécifiée portant le nom, la valeur, le domaine, le chemin d'accès, le délai d'expiration et la visibilité spécifiés.

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)

Paramètres

value

Byte[]

Valeur du cookie.

name

String

Nom du cookie.

path

String

Chemin d'accès du cookie.

domain

String

Domaine du cookie.

expirationTime

DateTime

Heure d’expiration du cookie ou DateTime.MinValue pour un cookie de session (session uniquement).

requiresSsl

Boolean

true si le cookie seul est utilisé sur une connexion SSL ; sinon, false.

hideFromClientScript

Boolean

true si le cookie doit être masqué dans le script client ; sinon, false.

context

HttpContext

HttpContext de la requête.

Exceptions

ArgumentNullException

value a la valeur null ou est vide.

ArgumentException

name a la valeur null ou est vide.