Compartilhar via


Application.SetCookie(Uri, String) Método

Definição

Cria um cookie para o local especificado 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

O Uri que especifica o local para o qual o cookie deve ser criado.

value
String

O String que contém os dados de cookie.

Exceções

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

Comentários

Um cookie é um dado arbitrário que pode ser armazenado por um aplicativo no computador cliente durante sessões de aplicativo (cookies de sessão) ou entre sessões de aplicativo (cookies persistentes). Você pode criar ambos os tipos de cookies chamando SetCookie.

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

Name=Value

Você passa uma cadeia de caracteres desse formato para SetCookie, juntamente com o Uri local para o qual o cookie deve ser definido (normalmente, o domínio do aplicativo).

Se um cookie é um cookie de sessão ou um cookie persistente depende se a cadeia de caracteres de cookie para a SetCookie qual você passa inclui uma data de expiração. A cadeia de caracteres de um cookie de sessão não inclui uma data de expiração. A cadeia de caracteres de um cookie persistente faz 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 de Arquivos de Internet Temporários da instalação Windows atual até expirarem, nesse caso, eles são excluídos. Você pode excluir um cookie persistente do aplicativo definindo sua data de expiração como um valor de data/hora que está no passado.

Para obter uma visão geral dos cookies no WPF, consulte Visão geral da navegação.

Aplica-se a

Confira também