CookieContainer.Add Methode

Definition

Fügt einer Cookie eine CookieContainer hinzu.Adds a Cookie to a CookieContainer.

Überlädt

Add(Cookie)

Fügt einer Cookie eine CookieContainer hinzu.Adds a Cookie to a CookieContainer. Diese Methode bestimmt mithilfe der Domäne aus dem Cookie, welcher Domänenauflistung das Cookie zugeordnet werden soll.This method uses the domain from the Cookie to determine which domain collection to associate the Cookie with.

Add(CookieCollection)

Fügt dem CookieCollection den Inhalt einer CookieContainer hinzu.Adds the contents of a CookieCollection to the CookieContainer.

Add(Uri, Cookie)

Fügt dem Cookie für einen bestimmten URI ein CookieContainer hinzu.Adds a Cookie to the CookieContainer for a particular URI.

Add(Uri, CookieCollection)

Fügt dem CookieCollection für einen bestimmten URI den Inhalt einer CookieContainer hinzu.Adds the contents of a CookieCollection to the CookieContainer for a particular URI.

Fügt einer Cookie eine CookieContainer hinzu.Adds a Cookie to a CookieContainer. Diese Methode bestimmt mithilfe der Domäne aus dem Cookie, welcher Domänenauflistung das Cookie zugeordnet werden soll.This method uses the domain from the Cookie to determine which domain collection to associate the Cookie with.

public:
 void Add(System::Net::Cookie ^ cookie);
public void Add (System.Net.Cookie cookie);
member this.Add : System.Net.Cookie -> unit

Parameter

cookie
Cookie

Die Cookie hinzuzufügende CookieContainer.The Cookie to be added to the CookieContainer.

Ausnahmen

cookie ist null.cookie is null.

Der cookie-Parameter ist null oder eine leere Zeichenfolge ("").The domain for cookie is null or the empty string ("").

cookie ist größer als maxCookieSize.cookie is larger than maxCookieSize.

- oder --or- die Domäne für cookie ist kein gültiger URI.the domain for cookie is not a valid URI.

Hinweise

Wenn die Count-Eigenschaft der Capacity-Eigenschaft gleicht oder überschreitet, werden mindestens eine Cookie Instanz aus dem Container entfernt, bevor der cookie-Parameter hinzugefügt wird.If the Count property equals or exceeds the Capacity property, one or more Cookie instances are removed from the container before adding the cookie parameter. Genug Cookie Instanzen entfernt werden, um Count unten Capacity wie folgt zu bringen: Wenn im angegebenen Bereich abgelaufene Instanzen vorhanden sind, werden Sie bereinigt.Enough Cookie instances are removed to bring Count below Capacity as follows: if there are expired instances in the given scope, they are cleaned up. Wenn dies nicht der Wert ist, wird der zuletzt verwendete CookieCollection gefunden und aus dem Container entfernt.If not, then the least recently used CookieCollection is found and removed from the container.

Siehe auch

Add(CookieCollection)

Fügt dem CookieCollection den Inhalt einer CookieContainer hinzu.Adds the contents of a CookieCollection to the CookieContainer.

public:
 void Add(System::Net::CookieCollection ^ cookies);
public void Add (System.Net.CookieCollection cookies);
member this.Add : System.Net.CookieCollection -> unit
Public Sub Add (cookies As CookieCollection)

Parameter

cookies
CookieCollection

Die CookieCollection hinzuzufügende CookieContainer.The CookieCollection to be added to the CookieContainer.

Ausnahmen

cookies ist null.cookies is null.

Hinweise

Wenn die Count-Eigenschaft der Capacity-Eigenschaft gleicht, werden mindestens eine Cookie Instanz aus dem Container entfernt, bevor der Inhalt des cookies-Parameters hinzugefügt wird.If the Count property equals the Capacity property, one or more Cookie instances are removed from the container before adding the contents of the cookies parameter. Genug Cookie Instanzen entfernt werden, um Platz für cookies wie folgt zu schaffen: Wenn abgelaufene Instanzen vorhanden sind, werden Sie bereinigt.Enough Cookie instances are removed to make room for cookies as follows: if there are expired instances, they are cleaned up. Wenn dies nicht der Wert ist oder mehr Platz benötigt wird, wird der zuletzt verwendete CookieCollection gefunden und aus dem Container entfernt.If not, or if more room is needed, then the least recently used CookieCollection is found and removed from the container.

Siehe auch

Fügt dem Cookie für einen bestimmten URI ein CookieContainer hinzu.Adds a Cookie to the CookieContainer for a particular URI.

public:
 void Add(Uri ^ uri, System::Net::Cookie ^ cookie);
public void Add (Uri uri, System.Net.Cookie cookie);
member this.Add : Uri * System.Net.Cookie -> unit

Parameter

uri
Uri

Der URI des Cookie, das dem CookieContainer hinzugefügt werden soll.The URI of the Cookie to be added to the CookieContainer.

cookie
Cookie

Die Cookie hinzuzufügende CookieContainer.The Cookie to be added to the CookieContainer.

Ausnahmen

uri ist null oder cookie ist null.uri is null or cookie is null.

cookie ist größer als maxCookieSize.cookie is larger than maxCookieSize.

- oder --or- Die Domäne für cookie ist kein gültiger URI.The domain for cookie is not a valid URI.

Hinweise

Wenn Sie eine Cookie Instanz nur für einen bestimmten Host hinzufügen, legen Sie die Domain-Eigenschaft der Cookie Instanz nicht fest.If you add a Cookie instance for just one specific host, do not set the Domain property of the Cookie instance. Dies wird basierend auf dem URI automatisch festgelegt.This is set automatically, based on the URI.

Wenn Ihr URI Ihrer lokalen Domäne entspricht und an alle Hosts in der lokalen Domäne sendet, legen Sie die CookieDomain-Eigenschaft gleich ". local" fest.If your URI corresponds to your local domain and sends to all the hosts on the local domain, set the CookieDomain property equal to ".local". Stellen Sie andernfalls sicher, dass Sie mit dem im URI verwendeten Hostnamen übereinstimmt.Otherwise, make sure it matches the host name used in the URI.

Wenn die Version-Eigenschaft eines Cookie Netscape ist, wird die Path-Eigenschaft der Cookie, wenn Sie nicht explizit festgelegt wird, vom URI abgeleitet und ist der komplette Pfad aus dem URI, einschließlich des Seiten namens.If the Version property of a Cookie is Netscape, the Path property of the Cookie, if not set explicitly, is derived from the URI and is the complete path from the URI, including the page name.

Wenn die Count-Eigenschaft der Capacity-Eigenschaft gleicht, werden mindestens eine Cookie Instanz aus dem Container entfernt, bevor der cookie-Parameter hinzugefügt wird.If the Count property equals the Capacity property, one or more Cookie instances are removed from the container before adding the cookie parameter. Genug Cookie Instanzen entfernt werden, um Count unten Capacity wie folgt zu bringen: Wenn sich abgelaufene Instanzen im Gültigkeitsbereich befinden, werden Sie bereinigt.Enough Cookie instances are removed to bring Count below Capacity as follows: if there are expired instances in scope, they are cleaned up. Wenn dies nicht der Wert ist, wird der zuletzt verwendete CookieCollection gefunden und aus dem Container entfernt.If not, then the least recently used CookieCollection is found and removed from the container.

Siehe auch

Add(Uri, CookieCollection)

Fügt dem CookieCollection für einen bestimmten URI den Inhalt einer CookieContainer hinzu.Adds the contents of a CookieCollection to the CookieContainer for a particular URI.

public:
 void Add(Uri ^ uri, System::Net::CookieCollection ^ cookies);
public void Add (Uri uri, System.Net.CookieCollection cookies);
member this.Add : Uri * System.Net.CookieCollection -> unit

Parameter

uri
Uri

Der URI des CookieCollection, das dem CookieContainer hinzugefügt werden soll.The URI of the CookieCollection to be added to the CookieContainer.

cookies
CookieCollection

Die CookieCollection hinzuzufügende CookieContainer.The CookieCollection to be added to the CookieContainer.

Ausnahmen

cookies ist null.cookies is null.

Die Domäne für eines der Cookies cookies ist null.The domain for one of the cookies in cookies is null.

Eines der Cookies in cookies enthält eine ungültige Domäne.One of the cookies in cookies contains an invalid domain.

Hinweise

Wenn Sie eine Cookie Instanz nur für einen bestimmten Host hinzufügen, legen Sie die Domain-Eigenschaft der Cookie Instanz nicht fest.If you add a Cookie instance for just one specific host, do not set the Domain property of the Cookie instance. Dies wird basierend auf dem URI automatisch festgelegt.This is set automatically, based on the URI.

Wenn Ihr URI Ihrer lokalen Domäne entspricht und an alle Hosts in der lokalen Domäne sendet, legen Sie die CookieDomain-Eigenschaft gleich ". local" fest.If your URI corresponds to your local domain and sends to all the hosts on the local domain, set the CookieDomain property equal to ".local". Stellen Sie andernfalls sicher, dass Sie mit dem im URI verwendeten Hostnamen übereinstimmt.Otherwise, make sure it matches the host name used in the URI.

Wenn Count Capacityentspricht, wird mindestens eine Cookie Instanz aus dem Container entfernt, bevor der cookie-Parameter hinzugefügt wird.If Count equals Capacity, one or more Cookie instances is removed from the container before adding the cookie parameter. Genug Cookie Instanzen entfernt werden, um Count unten Capacity wie folgt zu bringen: Wenn abgelaufene Instanzen im Gültigkeitsbereich vorhanden sind, werden Sie bereinigt.Enough Cookie instances are removed to bring Count below Capacity as follows: if there are expired instances in scope they are cleaned up. Wenn dies nicht der Wert ist, wird der zuletzt verwendete CookieCollection gefunden und aus dem Container entfernt.If not, then the least recently used CookieCollection is found and removed from the container.

Siehe auch

Gilt für: