This documentation is archived and is not being maintained.

HttpListenerRequest.Cookies Property

Note: This property is new in the .NET Framework version 2.0.

Gets the cookies sent with the request.

Namespace: System.Net
Assembly: System (in system.dll)

public CookieCollection Cookies { get; }
/** @property */
public CookieCollection get_Cookies ()

public function get Cookies () : CookieCollection

Property Value

A CookieCollection that contains cookies that accompany the request. This property returns an empty collection if the request does not contain cookies.

A cookie is name/value text data from a Web server that is stored on the local (client) computer.

The following code example displays the values of cookies sent with the request.

// This example requires the System and System.Net nam'espaces.
public static void DisplayCookies(HttpListenerRequest request)
    // Print the properties of each cookie.
    foreach (Cookie cook in request.Cookies)
        Console.WriteLine("{0} = {1}", cook.Name, cook.Value);
        Console.WriteLine("Domain: {0}", cook.Domain);
        Console.WriteLine("Path: {0}", cook.Path);
        Console.WriteLine("Port: {0}", cook.Port);
        Console.WriteLine("Secure: {0}", cook.Secure);
        Console.WriteLine("When issued: {0}", cook.TimeStamp);
        Console.WriteLine("Expires: {0} (expired? {1})", 
            cook.Expires, cook.Expired);
        Console.WriteLine("Don't save: {0}", cook.Discard);    
        Console.WriteLine("Comment: {0}", cook.Comment);
        Console.WriteLine("Uri for comments: {0}", cook.CommentUri);
        Console.WriteLine("Version: RFC {0}" , cook.Version == 1 ? "2109" : "2965");

        // Show the string representation of the cookie.
        Console.WriteLine ("String: {0}", cook.ToString());

Windows 98, Windows Server 2003, Windows XP Media Center Edition, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Supported in: 2.0