Cookie Klasse

Definition

Stellt eine Reihe von Eigenschaften und Methoden bereit, die zum Verwalten von Cookies verwendet werden. Diese Klasse kann nicht vererbt werden.

public ref class Cookie sealed
public sealed class Cookie
[System.Serializable]
public sealed class Cookie
type Cookie = class
[<System.Serializable>]
type Cookie = class
Public NotInheritable Class Cookie
Vererbung
Cookie
Attribute

Beispiele

Im folgenden Beispiel wird eine Anforderung an eine URL gesendet und die in der Antwort zurückgegebenen Cookies angezeigt.

using System.Net;
using System;
namespace Examples.System.Net.Cookies
{
    // This example is run at the command line.
    // Specify one argument: the name of the host to
    // send the request to.
    // If the request is sucessful, the example displays the contents of the cookies
    // returned by the host.

    public class CookieExample
    {
        public static void Main(string[] args)
        {
            if (args == null || args.Length != 1)
            {
                Console.WriteLine("Specify the URL to receive the request.");
                Environment.Exit(1);
            }
            var request = (HttpWebRequest)WebRequest.Create(args[0]);
            request.CookieContainer = new CookieContainer();

            using (var response = (HttpWebResponse) request.GetResponse())
            {
                // Print the properties of each cookie.
                foreach (Cookie cook in response.Cookies)
                {
                    Console.WriteLine("Cookie:");
                    Console.WriteLine($"{cook.Name} = {cook.Value}");
                    Console.WriteLine($"Domain: {cook.Domain}");
                    Console.WriteLine($"Path: {cook.Path}");
                    Console.WriteLine($"Port: {cook.Port}");
                    Console.WriteLine($"Secure: {cook.Secure}");

                    Console.WriteLine($"When issued: {cook.TimeStamp}");
                    Console.WriteLine($"Expires: {cook.Expires} (expired? {cook.Expired})");
                    Console.WriteLine($"Don't save: {cook.Discard}");
                    Console.WriteLine($"Comment: {cook.Comment}");
                    Console.WriteLine($"Uri for comments: {cook.CommentUri}");
                    Console.WriteLine($"Version: RFC {(cook.Version == 1 ? 2109 : 2965)}");

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

// Output from this example will be vary depending on the host name specified,
// but will be similar to the following.
/*
Cookie:
CustomerID = 13xyz
Domain: .contoso.com
Path: /
Port:
Secure: False
When issued: 1/14/2003 3:20:57 PM
Expires: 1/17/2013 11:14:07 AM (expired? False)
Don't save: False
Comment:
Uri for comments:
Version: RFC 2965
String: CustomerID = 13xyz
*/
Imports System.Net

' This example is run at the command line.
' Specify one argument: the name of the host to 
' receive the request.
' If the request is sucessful, the example displays the contents of the cookies
' returned by the host.

Public Class CookieExample
    
    Public Shared Sub Main(args() As String)
        If args Is Nothing OrElse args.Length <> 1 Then
            Console.WriteLine("Specify the URL to receive the request.")
            Environment.Exit(1)
        End If
        Dim request As HttpWebRequest = WebRequest.Create(args(0))
        request.CookieContainer = New CookieContainer()
    
        Using response As HttpWebResponse = request.GetResponse()
            ' Print the properties of each cookie.
            For Each cook As Cookie In response.Cookies
                Console.WriteLine("Cookie:")
                Console.WriteLine($"{cook.Name} = {cook.Value}")
                Console.WriteLine($"Domain: {cook.Domain}")
                Console.WriteLine($"Path: {cook.Path}")
                Console.WriteLine($"Port: {cook.Port}")
                Console.WriteLine($"Secure: {cook.Secure}")
    
                Console.WriteLine($"When issued: {cook.TimeStamp}")
                Console.WriteLine($"Expires: {cook.Expires} (expired? {cook.Expired})")
                Console.WriteLine($"Don't save: {cook.Discard}")
                Console.WriteLine($"Comment: {cook.Comment}")
                Console.WriteLine($"Uri for comments: {cook.CommentUri}")
                Console.WriteLine($"Version: RFC {If(cook.Version = 1, 2109, 2965)}")
    
                ' Show the string representation of the cookie.
                Console.WriteLine($"String: {cook}")
            Next
        End Using
    End Sub
End Class



' Output from this example will be vary depending on the host name specified,
' but will be similar to the following.
'
'Cookie:
'CustomerID = 13xyz
'Domain: .contoso.com
'Path: /
'Port:
'Secure: False
'When issued: 1/14/2003 3:20:57 PM
'Expires: 1/17/2013 11:14:07 AM (expired? False)
'Don't save: False
'Comment: 
'Uri for comments:
'Version: RFC 2965
'String: CustomerID = 13xyz
'

Hinweise

Die Cookie Klasse wird von einer Clientanwendung verwendet, um Informationen zu Cookies abzurufen, die mit HTTP-Antworten empfangen werden. Die folgenden Cookieformate werden während der Analyse der HTTP-Antwortheader unterstützt: die ursprüngliche Netscape-Spezifikation, RFC 2109 und RFC 2965.

Eine Liste der anfänglichen Eigenschaftswerte für eine Instanz von Cookie, finden Sie in den verschiedenen Cookie Konstruktoren.

Konstruktoren

Name Beschreibung
Cookie()

Initialisiert eine neue Instanz der Cookie-Klasse.

Cookie(String, String, String, String)

Initialisiert eine neue Instanz der Cookie Klasse mit einem angegebenen Name, Value, Pathund Domain.

Cookie(String, String, String)

Initialisiert eine neue Instanz der Cookie Klasse mit einem angegebenen Name, Valueund Path.

Cookie(String, String)

Initialisiert eine neue Instanz der Cookie Klasse mit einem angegebenen Name und Value.

Eigenschaften

Name Beschreibung
Comment

Ruft einen Kommentar ab, den der Server zu einem hinzufügen kann, oder legt diesen fest Cookie.

CommentUri

Dient zum Abrufen oder Festlegen eines URI-Kommentars, den der Server mit einem Cookie.

Discard

Ruft das vom Server festgelegte Verwerfen-Flag ab oder legt es fest.

Domain

Ruft den URI ab, für den der URI gültig ist, oder legt den Cookie URI fest.

Expired

Dient zum Abrufen oder Festlegen des aktuellen Zustands der Cookie.

Expires

Ruft ab oder legt das Ablaufdatum und die Uhrzeit für die Cookie als ein DateTime.

HttpOnly

Bestimmt, ob ein Seitenskript oder andere aktive Inhalte auf dieses Cookie zugreifen können.

Name

Dient zum Abrufen oder Festlegen des Namens für die Cookie.

Path

Dient zum Abrufen oder Festlegen der URIs, für die die Cookie Anwendung gilt.

Port

Dient zum Abrufen oder Festlegen einer Liste von TCP-Ports, für die die Cookie Anwendung gilt.

Secure

Dient zum Abrufen oder Festlegen der Sicherheitsstufe eines .Cookie

TimeStamp

Ruft die Zeit ab, zu der das Cookie als ein DateTime.

Value

Ruft ab oder legt den Value für die Cookie.

Version

Ruft die Version der HTTP-Zustandswartung ab, der das Cookie entspricht, oder legt diese fest.

Methoden

Name Beschreibung
Equals(Object)

Überschreibt die Equals(Object) Methode.

GetHashCode()

Überschreibt die GetHashCode() Methode.

GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
ToString()

Überschreibt die ToString() Methode.

Gilt für:

Weitere Informationen