Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

HttpListenerResponse.SetCookie-Methode

Hinweis: Diese Methode ist neu in .NET Framework, Version 2.0.

Fügt der Auflistung von mit dieser Antwort gesendeten Cookies ein Cookie hinzu oder aktualisiert dieses in der Auflistung.

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

public void SetCookie (
	Cookie cookie
)
public void SetCookie (
	Cookie cookie
)
public function SetCookie (
	cookie : Cookie
)

Parameter

cookie

Ein Cookie für diese Antwort.

AusnahmetypBedingung

ArgumentNullException

cookie ist NULL (Nothing in Visual Basic).

ArgumentException

Das Cookie ist bereits in der Auflistung vorhanden und konnte nicht ersetzt werden.

Zwei Cookies werden als identisch betrachten, wenn die Werte der Name-Eigenschaft, der Domain-Eigenschaft und der Path-Eigenschaft identisch sind. Wenn diese drei Informationen übereinstimmen, versucht die Methode, das Cookie zu aktualisieren. Beim Vergleich von Name und Domäne wird die Groß-/Kleinschreibung nicht berücksichtigt, jedoch wird sie beim Vergleich der Pfade berücksichtigt.

Im folgenden Codebeispiel wird das Aufrufen dieser Methode veranschaulicht.

// This example requires the System and System.Net namespaces.
public static void SimpleCookieExample(string[] prefixes)
{
    // Create a listener.
    HttpListener listener = new HttpListener();
    // Add the prefixes.
    foreach (string s in prefixes)
    {
        listener.Prefixes.Add(s);
    }
    listener.Start();
    Console.WriteLine("Listening...");
    // Note: The GetContext method blocks while waiting for a request. 
    HttpListenerContext context = listener.GetContext();
    HttpListenerRequest request = context.Request;
    
    // This application sends a cookie to the client marking the time 
    // they visited. 
    Cookie timeStampCookie = new Cookie("VisitDate", DateTime.Now.ToString());
    // Obtain a response object.
    HttpListenerResponse response = context.Response;
    // Add the cookie to the response.
    response.SetCookie(timeStampCookie);
    // Construct a response.
    string responseString = "<HTML><BODY> Hello world!</BODY></HTML>";
    response.ContentEncoding = System.Text.Encoding.UTF8;
    byte[] buffer = System.Text.Encoding.UTF8.GetBytes(responseString);
    // Send the response.
    response.Close(buffer, true);
    listener.Stop();
}

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

.NET Framework

Unterstützt in: 2.0
Anzeigen: