Application.SetCookie(Uri, String) Método

Definición

Crea una cookie para la ubicación especificada por Uri.Creates a cookie for the location specified by a 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)

Parámetros

uri
Uri

Uri que especifica la ubicación para la que se va a crear la cookie.The Uri that specifies the location for which the cookie should be created.

value
String

String que contiene los datos de la cookie.The String that contains the cookie data.

Excepciones

La función InternetSetCookie (a la que llama el método SetCookie(Uri, String)) provoca un error Win32Win32 si surge un problema cuando se intenta crear la cookie especificada.A Win32Win32 error is raised by the InternetSetCookie function (called by SetCookie(Uri, String)) if a problem occurs when attempting to create the specified cookie.

Comentarios

Una cookie es un fragmento de datos arbitrario que una aplicación puede almacenar en el equipo cliente durante las sesiones de aplicación (cookies de sesión) o entre sesiones de aplicación (cookies persistentes).A cookie is an arbitrary piece of data that can be stored by an application on the client machine during application sessions (session cookies) or across application sessions (persistent cookies). Puede crear ambos tipos de cookies llamando a SetCookie .You can create both types of cookies by calling SetCookie.

Los datos de la cookie suelen tomar la forma de un par nombre-valor en el formato siguiente:Cookie data typically takes the form of a name/value pair in the following format:

Name=Value

Pasa una cadena de este formato a SetCookie , junto con el Uri de la ubicación para la que se debe establecer la cookie (normalmente, el dominio de aplicación).You pass a string of this format to SetCookie, along with the Uri of the location for which the cookie should be set (typically, the application domain).

Si una cookie es una cookie de sesión o una cookie persistente depende de si la cadena de cookies que se pasa a SetCookie incluye una fecha de expiración.Whether a cookie is a session cookie or a persistent cookie depends on whether the cookie string that you pass to SetCookie includes an expiry date. La cadena de una cookie de sesión no incluye una fecha de expiración.The string for a session cookie does not include an expiry date. La cadena para una cookie persistente sí lo hace, y debe tener el formato siguiente:The string for a persistent cookie does, and must be in the following format:

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

Las cookies persistentes se almacenan en la WindowsWindows carpeta de archivos temporales de Internet de la instalación actual hasta que expiran, en cuyo caso se eliminan.Persistent cookies are stored in the current WindowsWindows installation's Temporary Internet Files folder until they expire, in which case they are deleted. Puede eliminar una cookie persistente de la aplicación estableciendo su fecha de expiración en un valor de fecha y hora que se encuentra en el pasado.You can delete a persistent cookie from your application by setting its expiry date to a date/time value that is in the past.

Para obtener información general sobre las cookies en WPFWPF , consulte información general sobre navegación.For an overview of cookies in WPFWPF, see Navigation Overview.

Se aplica a

Consulte también