Application.SetCookie(Uri, String) Método

Definição

Espaço de Nomes:

System.Windows

Assemblagem:

PresentationFramework.dll

Cria um cookie para a localização especificada por um 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

Isso Uri especifica o local para o qual o cookie deve ser criado.

value

String

O String que contém os dados dos cookies.

Exceções

Win32Exception

Um erro Win32 é gerado pela InternetSetCookie função (chamada por SetCookie(Uri, String)) se ocorrer um problema ao tentar criar o cookie especificado.

Observações

Um cookie é um dado arbitrário que pode ser armazenado por uma aplicação na máquina cliente durante sessões de aplicação (cookies de sessão) ou entre sessões de aplicação (cookies persistentes). Pode criar ambos os tipos de cookies ligando SetCookiepara .

Os dados de cookies normalmente assumem a forma de um par nome/valor no seguinte formato:

Name=Value

Passa uma string deste formato para SetCookie, juntamente com o Uri do local para o qual o cookie deve ser definido (tipicamente, o domínio da aplicação).

Se um cookie é um cookie de sessão ou um cookie persistente depende de a cadeia de cookies para a qual passa SetCookie incluir uma data de validade. A cadeia de um cookie de sessão não inclui uma data de validade. A cadeia para um cookie persistente tem, e deve estar no seguinte formato:

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

Os cookies persistentes são armazenados na pasta Ficheiros Temporários da Internet da instalação atual do Windows até expirarem, caso em que são eliminados. Pode eliminar um cookie persistente da sua aplicação definindo a data de expiração para um valor de data/hora que esteja no passado.

Para uma visão geral dos cookies no WPF, consulte Navigation Overview.

Ver também

• GetCookie(Uri)