Application.SetCookie(Uri, String) Méthode

Définition

Espace de noms:

System.Windows

Assembly:

PresentationFramework.dll

Crée un cookie pour l'emplacement spécifié par un Uri.

public:
 static void SetCookie(Uri ^ uri, System::String ^ value);

public static void SetCookie (Uri uri, string value);

static member SetCookie : Uri * string -> unit

Public Shared Sub SetCookie (uri As Uri, value As String)

Paramètres

uri

Uri

Uri qui spécifie l'emplacement pour lequel le cookie doit être créé.

value

String

String qui contient les données de cookie.

Exceptions

Win32Exception

Une erreur Win32 est générée par la InternetSetCookie fonction (appelée par SetCookie(Uri, String)) si un problème se produit lors de la tentative de création du cookie spécifié.

Remarques

Un cookie est un élément de données arbitraire qui peut être stocké par une application sur l’ordinateur client pendant les sessions d’application (cookies de session) ou entre les sessions d’application (cookies persistants). Vous pouvez créer les deux types de cookies en appelant SetCookie.

Les données de cookie prennent généralement la forme d’une paire nom/valeur au format suivant :

Name=Value

Vous passez une chaîne de ce format à SetCookie, ainsi que le de l’emplacement Uri pour lequel le cookie doit être défini (généralement, le domaine d’application).

Le fait qu’un cookie soit un cookie de session ou un cookie persistant varie selon que la chaîne de cookie que vous transmettez SetCookie inclut une date d’expiration. La chaîne d’un cookie de session n’inclut pas de date d’expiration. La chaîne d’un cookie persistant est et doit être au format suivant :

NAME=VALUE; expires=DAY, DD-MMM-YYYY HH:MM:SS GMT

Les cookies persistants sont stockés dans le dossier Fichiers Internet temporaires de l’installation windows actuelle jusqu’à leur expiration, auquel cas ils sont supprimés. Vous pouvez supprimer un cookie persistant de votre application en définissant sa date d’expiration sur une valeur date/heure antérieure.

Pour obtenir une vue d’ensemble des cookies dans WPF, consultez Vue d’ensemble de la navigation.

Voir aussi

• GetCookie(Uri)