Cookie Konstruktoren
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.
Ü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. |
Cookie()
- 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
, path
und domain
. Beachten Sie, dass mindestens die Name Eigenschaft initialisiert werden muss, bevor sie eine instance der Cookie -Klasse verwenden.
Gilt für:
Cookie(String, String)
- Quelle:
- Cookie.cs
- Quelle:
- Cookie.cs
- Quelle:
- Cookie.cs
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
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:
Cookie(String, String, String)
- Quelle:
- Cookie.cs
- Quelle:
- Cookie.cs
- Quelle:
- Cookie.cs
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
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:
Cookie(String, String, String, String)
- Quelle:
- Cookie.cs
- Quelle:
- Cookie.cs
- Quelle:
- Cookie.cs
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
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:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für