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

Qui Uri spécifie l’emplacement pour lequel le cookie doit être créé.

value
String

Qui String 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 arbitraire de données 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 transmettez une chaîne de ce format, SetCookieainsi que l’emplacement Uri pour lequel le cookie doit être défini (généralement, le domaine d’application).

Si un cookie est un cookie de session ou un cookie persistant dépend de la chaîne de cookie que vous passez pour SetCookie inclure 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 fait 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 jusqu'à ce qu'ils expirent, 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 de date/heure qui se trouve dans le passé.

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

S’applique à

Voir aussi