CookieHandler.Write Méthode

Définition

Espace de noms:

System.IdentityModel.Services

Assembly:

System.IdentityModel.Services.dll

Écrit un cookie.

Surcharges

Nom	Description
Write(Byte[], Boolean, DateTime)	Écrit un cookie associé à la requête actuelle qui a la valeur, la persistance et l’heure d’expiration spécifiées.
Write(Byte[], String, DateTime)	Écrit un cookie associé à la requête actuelle qui a le nom, la valeur et l’heure d’expiration spécifiés.
Write(Byte[], String, DateTime, HttpContext)	Écrit un cookie associé à la demande spécifiée qui a le nom, la valeur et l’heure d’expiration spécifiés.
Write(Byte[], String, String, String, DateTime, Boolean, Boolean, HttpContext)	Écrit un cookie associé à la requête spécifiée qui a le nom, la valeur, le domaine, le chemin d’accès, l’heure d’expiration et la visibilité spécifiés.

Write(Byte[], Boolean, DateTime)

Écrit un cookie associé à la requête actuelle qui a la valeur, la persistance et l’heure d’expiration spécifiées.

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 session uniquement, c’est-à-dire valide uniquement jusqu’à ce que le navigateur sur le client soit fermé.

tokenExpirationTime

DateTime

Heure d’expiration du jeton sous-jacent.

Exceptions

ArgumentNullException

value est null ou 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, l’heure d’expiration du cookie est définie sur la valeur de la PersistentSessionLifetime propriété si elle n’est pas null ou, si la PersistentSessionLifetime propriété est null, l’heure d’expiration est définie sur la valeur du tokenExpirationTime paramètre.

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

Write(Byte[], String, DateTime)

Écrit un cookie associé à la requête actuelle qui a le nom, la valeur et l’heure 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 est null ou vide.

ArgumentException

name est null ou vide.

Remarques

Le domaine et le chemin d’accès des cookies sont spécifiés par les propriétés et Path les Domain propriétés. La requête est spécifiée par HttpContext.Current. La requête est spécifiée par Current. Si le cookie doit être envoyé uniquement via SSL est spécifié par la RequireSsl propriété et si le cookie doit être masqué des 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 qui a le nom, la valeur et l’heure 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

Pour HttpContext la demande.

Exceptions

ArgumentNullException

value est null ou vide.

ArgumentException

name est null ou vide.

Remarques

Le domaine et le chemin d’accès des cookies sont spécifiés par les propriétés et Path les Domain propriétés. La requête est spécifiée par Current. Si le cookie doit être envoyé uniquement via SSL est spécifié par la RequireSsl propriété et si le cookie doit être masqué des 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 requête spécifiée qui a le nom, la valeur, le domaine, le chemin d’accès, l’heure 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 doit uniquement être utilisé via une connexion SSL ; sinon, false.

hideFromClientScript

Boolean

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

context

HttpContext

Pour HttpContext la demande.

Exceptions

ArgumentNullException

value est null ou vide.

ArgumentException

name est null ou vide.