HttpCookieCollection.Add Method (System.Web)

Add Method

Switch on low bandwidth view

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

HttpCookieCollection..::.Add Method

Adds the specified cookie to the cookie collection.

Namespace: System.Web
Assembly: System.Web (in System.Web.dll)

Syntax

Visual Basic (Declaration)

Public Sub Add ( _
    cookie As HttpCookie _
)

Visual Basic (Usage)

Dim instance As HttpCookieCollection
Dim cookie As HttpCookie

instance.Add(cookie)

public void Add(
    HttpCookie cookie
)

Visual C++

public:
void Add(
    HttpCookie^ cookie
)

JScript

public function Add(
    cookie : HttpCookie
)

Parameters

cookie: Type: System.Web..::.HttpCookie
The HttpCookie to add to the collection.

Remarks

Any number of cookie collections can exist within an application, but only the collection referenced by the intrinsic Cookies object is sent to the client.

The Add method allows duplicate cookies in the cookie collection. Use the Set method to ensure the uniqueness of cookies in the cookie collection.

Examples

The following example creates a new cookie collection and a new cookie named "LastVisit", sets the value of the cookie to the current date and time, and adds the cookie to the new collection.

Visual Basic

Dim MyCookieCollection as New HttpCookieCollection()
 Dim MyCookie As New HttpCookie("LastVisit")
 MyCookie.Value = DateTime.Now().ToString()
 MyCookieCollection.Add(MyCookie)

HttpCookieCollection MyCookieCollection = new HttpCookieCollection();
 HttpCookie MyCookie = new HttpCookie("LastVisit");
 MyCookie.Value = DateTime.Now.ToString();
 MyCookieCollection.Add(MyCookie);

JScript

var myCookieCollection : HttpCookieCollection = new HttpCookieCollection()
var myCookie : HttpCookie = new HttpCookie("LastVisit")
myCookie.Value = DateTime.Now.ToString()
myCookieCollection.Add(myCookie)

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

Reference

HttpCookieCollection Class

HttpCookieCollection Members

System.Web Namespace

Clear

Set