Cookie Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 | |
| 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. |