Coleção ASP Cookies

Manual de Referência do Objeto Request

A coleção Cookies é usada para configurar ou obter o valor do cookie. Se o cookie não existir, ele será criado e atribuído o valor especificado.

Comentário:O comando Response.Cookies deve estar antes da tag <html>.

Sintaxe:

Response.Cookies(name)[(key)|.attribute]=value
variablename=Request.Cookies(name)[(key)|.attribute]
Parâmetros Descrição
name Obrigatório. O nome do cookie.
value Obrigatório (para o comando Response.Cookies). O valor do cookie.
attribute

Opcional. Especifica informações sobre o cookie. Pode ser um dos seguintes parâmetros.

  • Domain - Somente leitura; o cookie será enviado apenas para solicitações que cheguem a este domínio.
  • Expires - Somente leitura; data de expiração do cookie. Se não for especificada uma data, o cookie expirará no final da sessão.
  • HasKeys - Somente leitura; especifica se o cookie possui key (este é o único atributo que pode ser usado com o comando Request.Cookies)
  • Path - Somente leitura; se configurado, o cookie será enviado apenas para solicitações que cheguem a este caminho. Se não for configurado, será usado o caminho do aplicativo.
  • Secure - Somente leitura; indica se o cookie é seguro.
key Opcional. Especifica o local onde o valor será atribuído ao key.

Exemplo

"Response.Cookies" é uma comando usado para criar cookies ou configurar o valor do cookie:

<%
Response.Cookies("firstname")="Alex"
%>

No código acima, criamos um cookie chamado "firstname" e atribuímos a ele o valor "alex".

Também pode ser configurado atributos para cookies, por exemplo, configurar o tempo de expiração do cookie:

<%
Response.Cookies("firstname")="Alex"　
Response.Cookies("firstname").Expires=#May 10,2002#
%>

Agora, o valor do cookie chamado "firstname" é "Alex", e a data de expiração dele no computador do usuário é 10 de maio de 2002.

O comando "Request.Cookies" é usado para recuperar os valores dos cookies.

Neste exemplo, recolhemos o valor do cookie "firstname" e o mostramos na página:

<%
fname=Request.Cookies("firstname")
response.write("Firstname=" & fname)
%>

Saída:

Firstname=Alex

Um cookie pode conter um conjunto de múltiplos valores. Chamamos isso de cookie que possui keys.

Neste exemplo, vamos criar um conjunto de cookies chamado "user" que possui keys contendo informações sobre o usuário.

<%
Response.Cookies("user")("firstname")="John"
Response.Cookies("user")("lastname")="Adams"
Response.Cookies("user")("country")="UK"
Response.Cookies("user")("age")="25"
%>

O código a seguir pode ler todos os cookies que o servidor enviou ao usuário. Atente para que usamos a propriedade HasKeys para determinar se o cookie possui keys:

<html>
<body>
<%
dim x,y
for each x in Request.Cookies
  response.write("<p>")
  if Request.Cookies(x).HasKeys then
    for each y in Request.Cookies(x)
      response.write(x & ":" & y & "=" & Request.Cookies(x)(y))
      response.write("<br /")
    next
  else
    Response.Write(x & "=" & Request.Cookies(x) & "<br />")
  fim se
  response.write "</p>"
next
%>
</body>
</html>
%>

Saída:

firstname=Alex
user:firstname=John
user:lastname=Adams
user:
country=UK
user:
age=25

Manual de Referência do Objeto Request