Freigeben über

Cookie Konstruktoren

  • Referenz

Definition

Namespace:
System.Net
Assembly:
System.Net.Primitives.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Initialisiert eine neue Instanz der Cookie Klasse. Im Allgemeinen muss eine Anwendung keine Cookie Klasse erstellen, da sie automatisch basierend auf dem Set-Cookie Header erstellt wird, der mit der HTTP-Antwort empfangen wurde.

Überlädt

Cookie()

Initialisiert eine neue Instanz der Cookie Klasse.
Cookie(String, String)

Initialisiert eine neue Instanz der Cookie Klasse mit einem angegebenen Name und Value.
Cookie(String, String, String)

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

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

Initialisiert eine neue Instanz der Cookie Klasse.

public:
 Cookie();
public Cookie ();
Public Sub New ()

Hinweise

Der parameterlose Konstruktor initialisiert alle Felder mit ihren Standardwerten, wobei leere Zeichenfolgen ("") für name, value, pathund domainverwendet werden. Beachten Sie, dass mindestens die Name-Eigenschaft initialisiert werden muss, bevor sie eine Instanz der Cookie Klasse verwenden.

Gilt für:

Quelle:
Cookie.cs
Quelle:
Cookie.cs
Quelle:
Cookie.cs

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

public:
 Cookie(System::String ^ name, System::String ^ value);
public Cookie (string name, string value);
public Cookie (string name, string? value);
new System.Net.Cookie : string * string -> System.Net.Cookie
Public Sub New (name As String, value As String)

Parameter

name
String

Der Name eines Cookie. Die folgenden Zeichen dürfen nicht in nameverwendet werden: Gleichheitszeichen, Semikolon, Komma, Neulinie (\n), Rückgabe (\r), Tabulatorzeichen (\t) und Leerzeichen. Das Dollarzeichen ("$") darf nicht das erste Zeichen sein.

value
String

Der Wert eines Cookie. Die folgenden Zeichen dürfen nicht in valueverwendet werden: Semikolon, Komma.

Ausnahmen

CookieException

Der parameter name ist null.

-oder-

Der name-Parameter hat die Länge null.

-oder-

Der parameter name enthält ein ungültiges Zeichen.

-oder-

Der parameter value ist null .

-oder-

Der parameter value enthält eine Zeichenfolge, die nicht in Anführungszeichen eingeschlossen ist, die ein ungültiges Zeichen enthält.

Hinweise

Der Standardwert für den parameter value verwendet die leere Zeichenfolge ("").

Der value-Parameter für eine Cookie darf kein null Verweis sein (Nothing in Visual Basic). Die Zeichen Semikolon (";") und Komma (",") sind reserviert und können nicht im value-Parameter übergeben werden, es sei denn, die im parameter value übergebene Zeichenfolge wird in doppelte Anführungszeichen eingeschlossen. Der folgende Beispielkonstruktor würde also erfolgreich sein, aber wenn Sie versuchen, diese Cookie einer CookieContainer Instanz mit den Methoden Add(Cookie) oder Add(Uri, Cookie) hinzuzufügen, schlägt der Vorgang fehl und löst eine Ausnahme aus:

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "123,456");
cookie.Domain = "contoso.com";
new CookieContainer().Add(cookie);

Der folgende Konstruktor mit diesen Sonderzeichen mit Escapezeichen erstellt jedoch eine Cookie, die einer CookieContainer Instanz hinzugefügt werden kann:

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "\"123,456\"");
cookie.Domain = "contoso.com";
new CookieContainer().Add(cookie);

Das Kommazeichen wird als Trennzeichen zwischen getrennten Cookies in derselben Zeile verwendet.

Weitere Informationen

Gilt für:

Quelle:
Cookie.cs
Quelle:
Cookie.cs
Quelle:
Cookie.cs

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

public:
 Cookie(System::String ^ name, System::String ^ value, System::String ^ path);
public Cookie (string name, string value, string path);
public Cookie (string name, string? value, string? path);
new System.Net.Cookie : string * string * string -> System.Net.Cookie
Public Sub New (name As String, value As String, path As String)

Parameter

name
String

Der Name eines Cookie. Die folgenden Zeichen dürfen nicht in nameverwendet werden: Gleichheitszeichen, Semikolon, Komma, Neulinie (\n), Rückgabe (\r), Tabulatorzeichen (\t) und Leerzeichen. Das Dollarzeichen ("$") darf nicht das erste Zeichen sein.

value
String

Der Wert eines Cookie. Die folgenden Zeichen dürfen nicht in valueverwendet werden: Semikolon, Komma.

path
String

Die Teilmenge der URIs auf dem Ursprungsserver, auf den diese Cookie angewendet wird. Der Standardwert ist "/".

Ausnahmen

CookieException

Der parameter name ist null.

-oder-

Der name-Parameter hat die Länge null.

-oder-

Der parameter name enthält ein ungültiges Zeichen.

-oder-

Der parameter value ist null .

-oder-

Der parameter value enthält eine Zeichenfolge, die nicht in Anführungszeichen eingeschlossen ist, die ein ungültiges Zeichen enthält.

Hinweise

Der Standardwert für den parameter path verwendet die leere Zeichenfolge ("").

Der value-Parameter für eine Cookie darf kein null Verweis sein (Nothing in Visual Basic). Die Zeichen Semikolon (";") und Komma (",") sind reserviert und können nicht im value-Parameter übergeben werden, es sei denn, die im parameter value übergebene Zeichenfolge wird in doppelte Anführungszeichen eingeschlossen. Der folgende Beispielkonstruktor würde also erfolgreich sein, aber wenn Sie versuchen, diese Cookie einer CookieContainer Instanz mit den Methoden Add(Cookie) oder Add(Uri, Cookie) hinzuzufügen, schlägt der Vorgang fehl und löst eine Ausnahme aus:

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "123,456", "");
cookie.Domain = "contoso.com";
new CookieContainer().Add(cookie);

Der folgende Konstruktor mit diesen Sonderzeichen mit Escapezeichen erstellt jedoch eine Cookie, die einer CookieContainer Instanz hinzugefügt werden kann:

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "\"123,456\"", "");
cookie.Domain = "contoso.com";
new CookieContainer().Add(cookie);

Das Kommazeichen wird als Trennzeichen zwischen getrennten Cookies in derselben Zeile verwendet.

Weitere Informationen

Gilt für:

Quelle:
Cookie.cs
Quelle:
Cookie.cs
Quelle:
Cookie.cs

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

public:
 Cookie(System::String ^ name, System::String ^ value, System::String ^ path, System::String ^ domain);
public Cookie (string name, string value, string path, string domain);
public Cookie (string name, string? value, string? path, string? domain);
new System.Net.Cookie : string * string * string * string -> System.Net.Cookie
Public Sub New (name As String, value As String, path As String, domain As String)

Parameter

name
String

Der Name eines Cookie. Die folgenden Zeichen dürfen nicht in nameverwendet werden: Gleichheitszeichen, Semikolon, Komma, Neulinie (\n), Rückgabe (\r), Tabulatorzeichen (\t) und Leerzeichen. Das Dollarzeichen ("$") darf nicht das erste Zeichen sein.

value
String

Der Wert eines Cookie-Objekts. Die folgenden Zeichen dürfen nicht in valueverwendet werden: Semikolon, Komma.

path
String

Die Teilmenge der URIs auf dem Ursprungsserver, auf den diese Cookie angewendet wird. Der Standardwert ist "/".

domain
String

Die optionale Internetdomäne, für die diese Cookie gültig ist. Der Standardwert ist der Host, von dem Cookie empfangen wurde.

Ausnahmen

CookieException

Der parameter name ist null.

-oder-

Der name-Parameter hat die Länge null.

-oder-

Der parameter name enthält ein ungültiges Zeichen.

-oder-

Der parameter value ist null .

-oder-

Der parameter value enthält eine Zeichenfolge, die nicht in Anführungszeichen eingeschlossen ist, die ein ungültiges Zeichen enthält.

Hinweise

Der Standardwert für die Parameter domain und path verwendet die leere Zeichenfolge ("").

Der value-Parameter für eine Cookie darf kein null Verweis sein (Nothing in Visual Basic). Die Zeichen Semikolon (";") und Komma (",") sind reserviert und können nicht im value-Parameter übergeben werden, es sei denn, die im parameter value übergebene Zeichenfolge wird in doppelte Anführungszeichen eingeschlossen. Der folgende Beispielkonstruktor würde also erfolgreich sein, aber wenn Sie versuchen, diese Cookie einer CookieContainer Instanz mit den Methoden Add(Cookie) oder Add(Uri, Cookie) hinzuzufügen, schlägt der Vorgang fehl und löst eine Ausnahme aus:

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "123,456", "", "contoso.com");
new CookieContainer().Add(cookie);

Der folgende Konstruktor mit diesen Sonderzeichen mit Escapezeichen erstellt jedoch eine Cookie, die einer CookieContainer Instanz hinzugefügt werden kann:

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "\"123,456\"", "", "contoso.com");
new CookieContainer().Add(cookie);

Das Kommazeichen wird als Trennzeichen zwischen getrennten Cookies in derselben Zeile verwendet.

Weitere Informationen

Gilt für: