Sun Chili!Soft ASP Sun Chili!Soft
ASP Sun Microsystems


ASP Response Object Cookies Collection

The Cookies collection sets the value of a cookie. If a specified cookie does not exist, it is created. If it does exist, the cookie takes on the new value and the old value is discarded.

Syntax: ASP Response Object Cookies Collection

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

Parameters: ASP Response Object Cookies Collection


The name of the cookie.


Optional. If key is specified, the cookie is a dictionary and key is set to value.


Specific information about the cookie itself. The attribute can be one of the following:




The date on which the cookie expires. This attribute must be set to a date later than the current date to store the cookie on the client disk after the current session ends. Write-only.


Indicates that the cookie has keys. Read-only.


If set, the cookie is only sent to requests on this path. If the attribute is not set, the application path is used. Write-only.


Indicates that the cookie is secure. Write-only.


Specifies the value to assign to key or attribute.

Remarks: ASP Response Object Cookies Collection

If a cookie with keys is created, as in the following script:

Response.Cookies("myCookie")("type1") = "sugar"

Response.Cookies("myCookie")("type2") = "ginger snap"

the following header is sent:


Any subsequent assignment to myCookie that does not include a key would destroy type1 and type2. The following example discards the values type1 and type2 and replaces them with the value "chocolate chip":

Response.Cookies("myCookie") = "chocolate chip"

Conversely, calling a cookie with a key destroys any non-key values the cookie might contain. The following code will discard the value "chocolate chip" and insert the key value instead:

Response.Cookies("myCookie") ("NewType") = "peanut butter"

To check to see if a cookie has key values, use the following:


If myCookie is a dictionary and has keys, the previous script will evaluate to TRUE, otherwise it will be FALSE.

You can use an iterator to set cookie attributes. The following example sets all the cookies in a collection to expire on Dec. 31, 1999:


For each cookie in Response.Cookies

Response.Cookies(cookie).ExpiresAbsolute = #Dec. 31, 1999# 



An iterator can also be used to set the values of all the cookies in a collection, or all the keys in a cookie. However, when using an iterator to retrieve cookie values, the cookies must have keys or the iterator will not execute. Use the HasKeys property to check to see whether a cookie has any keys. This is demonstrated in the following example.


If Not cookie.HasKeys Then

'Set the value of the cookie  

Response.Cookies(cookie) = "" 


'Set the value for each key in the cookie collection  

For Each key in Response.Cookies(cookie) 

Response.Cookies(cookie)(key) = ""  

Next key 


Examples: ASP Response Object Cookies Collection

The following example shows how you can set cookie values and their attributes:


Response.Cookies("Type") = "Chocolate Chip"

Response.Cookies("Type").Expires = "July 31, 1997"

Response.Cookies("Type").Domain = ""

Response.Cookies("Type").Path = "/www/home/"

Response.Cookies("Type").Secure = FALSE


Copyright 2002 Sun Microsystems, Inc. All rights reserved. Legal Notice.