Coleção ASP Cookies

Manual de Referência do Objeto Response

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

Comentário:A instrução 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 a instrução Response.Cookies). O valor do cookie.
attribute

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

  • Domain - só leitura; o cookie será enviado apenas para solicitações que cheguem a este domínio.
  • Expires - só leitura; data de expiração do cookie. Se não for especificada uma data, o cookie expirará no final da sessão.
  • HasKeys - só leitura; define se o cookie possui chave (é a única propriedade que pode ser usada com a instrução Request.Cookies)
  • Path - só leitura; se definido, o cookie será enviado apenas para solicitações que cheguem a este caminho. Se não for definido, será usado o caminho do aplicativo.
  • Secure - só leitura; indica se o cookie é seguro.
chave Opcional. Define o local onde o valor será atribuído para a chave.

Exemplo

"Response.Cookies" é uma instrução usada para criar cookies ou definir o valor de cookies:

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

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

Também pode definir atributos para cookies, por exemplo, definir 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 no computador do usuário é 10 de maio de 2002.

"Request.Cookies" é usado para recuperar o valor do cookie.

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. Nós chamamos isso de cookie com chave.

Neste exemplo, vamos criar um conjunto de cookies chamado "user" que possui chaves 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"
%>

Aqui está o código que pode ler todos os cookies que o servidor enviou ao usuário. Por favor, note que usamos a propriedade HasKeys para determinar se o cookie possui chave:

<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 Response