ASP CookiesCollection

Response 对象参考手册Complete Response Object Reference

The Cookies collection is used to set or retrieve the value of a cookie. If the cookie does not exist, it is created and assigned the specified value.

Note:The Response.Cookies command must be placed before the <html> tag.

Syntax

Response.Cookies(name)[(key)|.attribute]=value

variablename=Request.Cookies(name)[(key)|.attribute]

Parameters Description
name Required. The name of the cookie.
value Required (for the Response.Cookies command). The value of the cookie.
attribute Optional. Specifies information about the cookie. Can be one of the following parameters:
  • Domain - Write-only. The cookie is only sent to requests reaching that domain.
  • Expires - Write-only. The expiration date of the cookie. If no date is specified, the cookie expires when the session ends.
  • HasKeys - Read-only. Specifies whether the cookie has keys (this is the only property that can be used with the Request.Cookies command).
  • Path - Write-only. If set, the cookie is only sent to requests reaching this path. If not set, the application's path is used.
  • Secure - Write-only. Indicates whether the cookie is secure.
key Optional. Specifies the key where the value is assigned.

Examples

The "Response.Cookies" command is used to create a cookie or set the value of a cookie:

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

In the code above, we created a cookie named "firstname" and assigned it the value "Alex".

Properties can also be set for a cookie, for example, setting the expiration time of the cookie:

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

Now, the value of the cookie named "firstname" is "Alex", and its expiration date on the user's computer is May 10, 2002.

The "Request.Cookies" command is used to retrieve the value of a cookie.

In the example below, we retrieve the value of the cookie "firstname" and display it on the page:

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

Output:
Firstname=Alex

A cookie can contain a collection of multiple values. We refer to this as a cookie having keys.

In the example below, we create a cookie collection named "user". The "user" cookie has keys containing information about the user:

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

The following code reads all cookies that the server has sent to the user. Note that we use the HasKeys property to determine whether a cookie has 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>")
  end if
  response.write "</p>"
next
%>

</body>
</html>
%>

Output:

firstname=Alex

user:firstname=John
user:lastname=Smith
user:
country=Norway
user:
age=25


Response 对象参考手册Complete Response Object Reference Other Extensions