Export (0) Print
Expand All

HttpListenerResponse.AppendCookie Method

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

Adds the specified Cookie to the collection of cookies for this response.

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

'Declaration
Public Sub AppendCookie ( _
	cookie As Cookie _
)
'Usage
Dim instance As HttpListenerResponse
Dim cookie As Cookie

instance.AppendCookie(cookie)
public void AppendCookie (
	Cookie cookie
)
public function AppendCookie (
	cookie : Cookie
)

Parameters

cookie

The Cookieto add to the collection to be sent with this response

Exception typeCondition

ArgumentNullException

cookie is a null reference (Nothing in Visual Basic).

Calling this method is equivalent to calling the Add method on the collection returned by the Cookies property.

If the specified cookie does not exist in the Cookies property's collection, cookie is added. If the cookie exists in the collection, cookie replaces it.

The following code example demonstrates adding a cookie to a response

// This example requires the System and System.Net namespaces.

public static string NextCustomerID()
{
    // A real-world application would do something more robust
    // to ensure uniqueness.
    return DateTime.Now.ToString();
}
public static void SimpleListenerCookieExample(string[] prefixes)
{
    // Create a listener.
    HttpListener listener = new HttpListener();
    // Add the prefixes.
    foreach (string s in prefixes)
    {
        listener.Prefixes.Add(s);
    }
    listener.IgnoreWriteExceptions = true;
    listener.Start();
    Console.WriteLine("Listening...");
    // Note: The GetContext method blocks while waiting for a request. 
    HttpListenerContext context = listener.GetContext();
    HttpListenerRequest request = context.Request;
    string customerID = null;

    // Did the request come with a cookie?
    Cookie cookie = request.Cookies["ID"];
    if (cookie != null)
    {
         customerID=cookie.Value;
    }
    if (customerID !=null)
    {
          Console.WriteLine("Found the cookie!");
    }
    // Get the response object.
    HttpListenerResponse response = context.Response;
    // If they didn't provide a cookie containing their ID, give them one.
    if (customerID == null)
    {
        customerID = NextCustomerID();
        Cookie cook = new Cookie("ID", customerID );
        response.AppendCookie (cook);
    }
    // Construct a response.
    string responseString = "<HTML><BODY> Hello " + customerID + "!</BODY></HTML>";
    byte[] buffer = System.Text.Encoding.UTF8.GetBytes(responseString);
    // Get the response stream and write the response to it.
    response.ContentLength64 = buffer.Length;
    System.IO.Stream output = response.OutputStream;
    output.Write(buffer,0,buffer.Length);
    // You must close the output stream.
    output.Close();
    // Closing the response sends the response to the client.
    response.Close();
    listener.Stop();
}

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

Community Additions

ADD
Show:
© 2014 Microsoft