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 diese automatisch auf der Grundlage des Set-Cookie-Headers 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 einer angegebenen Name und Value.
Cookie(String, String, String)

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

Initialisiert eine neue Instanz der Cookie-Klasse mit einem angegebenen Name, Value, Path und 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 und verwendet leere Zeichenfolgen ("") für name, value, pathund domain. Beachten Sie, dass mindestens die Name Eigenschaft initialisiert werden muss, bevor sie eine instance der Cookie -Klasse verwenden.

Gilt für:

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

Initialisiert eine neue Instanz der Cookie-Klasse mit einer 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 in name nicht verwendet werden: Gleichheitszeichen, Semikolon, Komma, Zeilenvorschub (\n), Wagenrücklauf (\r), Tabstopp (\t) und Leerzeichen. Das Dollarzeichen („$“) darf nicht das erste Zeichen sein.

value
String

Der Wert eines Cookie. Die folgenden Zeichen dürfen nicht in value verwendet werden: Semikolon und Komma.

Ausnahmen

CookieException

Der name-Parameter ist null.

- oder -

Der name-Parameter hat die Länge 0 (null).

- oder -

Der name-Parameter enthält ein ungültiges Zeichen.

- oder -

Der value-Parameter ist null.

- oder -

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

Hinweise

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

Der value Parameter für ein Cookie darf kein Verweis sein null (Nothing in Visual Basic). Die Zeichen Semikolons (";") und Kommas (",") sind reserviert und können nicht im value Parameter übergeben werden, es sei denn, die im value Parameter übergebene Zeichenfolge wird in doppelte Anführungszeichen eingeschlossen. Der folgende Beispielkonstruktor ist also erfolgreich, aber wenn Sie versuchen, dies Cookie einer CookieContainer instance mit den Add(Cookie) Methoden 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 erstellt jedoch eineCookie, die einem CookieContainer instance 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 separaten 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 und 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 in name nicht verwendet werden: Gleichheitszeichen, Semikolon, Komma, Zeilenvorschub (\n), Wagenrücklauf (\r), Tabstopp (\t) und Leerzeichen. Das Dollarzeichen („$“) darf nicht das erste Zeichen sein.

value
String

Der Wert eines Cookie. Die folgenden Zeichen dürfen nicht in value verwendet werden: Semikolon und Komma.

path
String

Die Teilmenge von URIs auf dem Ursprungsserver, für die dieses Cookie gültig ist. Der Standardwert ist „/“.

Ausnahmen

CookieException

Der name-Parameter ist null.

- oder -

Der name-Parameter hat die Länge 0 (null).

- oder -

Der name-Parameter enthält ein ungültiges Zeichen.

- oder -

Der value-Parameter ist null.

- oder -

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

Hinweise

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

Der value Parameter für ein Cookie darf kein Verweis sein null (Nothing in Visual Basic). Die Zeichen Semikolons (";") und Kommas (",") sind reserviert und können nicht im value Parameter übergeben werden, es sei denn, die im value Parameter übergebene Zeichenfolge wird in doppelte Anführungszeichen eingeschlossen. Der folgende Beispielkonstruktor ist also erfolgreich, aber wenn Sie versuchen, dies Cookie einer CookieContainer instance mit den Add(Cookie) Methoden 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 erstellt jedoch eineCookie, die einem CookieContainer instance 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 separaten 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, Path und 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 in name nicht verwendet werden: Gleichheitszeichen, Semikolon, Komma, Zeilenvorschub (\n), Wagenrücklauf (\r), Tabstopp (\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 value verwendet werden: Semikolon und Komma.

path
String

Die Teilmenge von URIs auf dem Ursprungsserver, für die dieses Cookie gültig ist. Der Standardwert ist „/“.

domain
String

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

Ausnahmen

CookieException

Der name-Parameter ist null.

- oder -

Der name-Parameter hat die Länge 0 (null).

- oder -

Der name-Parameter enthält ein ungültiges Zeichen.

- oder -

Der value-Parameter ist null.

- oder -

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

Hinweise

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

Der value Parameter für ein Cookie darf kein Verweis sein null (Nothing in Visual Basic). Die Zeichen Semikolons (";") und Kommas (",") sind reserviert und können nicht im value Parameter übergeben werden, es sei denn, die im value Parameter übergebene Zeichenfolge wird in doppelte Anführungszeichen eingeschlossen. Der folgende Beispielkonstruktor ist also erfolgreich, aber wenn Sie versuchen, dies Cookie einer CookieContainer instance mit den Add(Cookie) Methoden 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 erstellt jedoch eineCookie, die einem CookieContainer instance 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 separaten Cookies in derselben Zeile verwendet.

Weitere Informationen

Gilt für: