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 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. |
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, 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:
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.CookiePublic 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
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:
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.CookiePublic 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
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:
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.CookiePublic 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
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.
