Freigeben über


CookieContainer Klasse

Definition

Stellt einen Container für eine Auflistung von CookieCollection -Objekten bereit.

public ref class CookieContainer
public ref class CookieContainer sealed
public class CookieContainer
[System.Serializable]
public class CookieContainer
public sealed class CookieContainer
type CookieContainer = class
[<System.Serializable>]
type CookieContainer = class
Public Class CookieContainer
Public NotInheritable Class CookieContainer
Vererbung
CookieContainer
Attribute

Hinweise

Ein CookieContainer ist eine Datenstruktur, die Speicher für Instanzen der Cookie-Klasse bereitstellt und auf datenbankähnliche Weise zugegriffen wird. Die CookieContainer weist eine Kapazitätsbeschränkung auf, die festgelegt wird, wenn der Container von einer Eigenschaft erstellt oder geändert wird.

Eine Instanz der Cookie-Klasse wird dem Container basierend auf seinem ursprünglichen URI hinzugefügt. Sie wird zu einer internen CookieCollection hinzugefügt, die dem URI zugeordnet ist. Ein Cookie wird vom Container basierend auf dem URI als CookieCollectionoder als Zeichenfolge abgerufen, die zum Senden von HTTP-WebRequests verwendet werden kann.

Die CookieContainer verfügt über drei Eigenschaften, die das Volumen des Inhalts des Containers steuern: Capacity, MaxCookieSizeund PerDomainCapacity. Diese Werte weisen die Standardeinstellungen 300, 4096 bzw. 20 auf. Wenn dem Container ein Cookie hinzugefügt wird, werden diese Eigenschaften verwendet, um zu bestimmen, ob ein bereits im CookieContainer enthaltenes Cookie verworfen werden soll, um Platz für das neue zu schaffen. Die CookieContainer verfolgt jede Ergänzung, um sicherzustellen, dass weder die Capacity noch die PerDomainCapacity Grenzwerte überschritten werden. Wenn eine oder beide überschritten werden, werden Cookie Instanzen, die von der CookieContainer gehalten werden, entfernt. Zuerst werden alle abgelaufenen Cookie entfernt. Wenn weitere Kapazität zurückgefangen werden muss, wird die zuletzt verwendete CookieCollection gelöscht.

Konstruktoren

CookieContainer()

Initialisiert eine neue Instanz der CookieContainer Klasse.

CookieContainer(Int32, Int32, Int32)

Initialisiert eine neue Instanz der CookieContainer Klasse mit bestimmten Eigenschaften.

CookieContainer(Int32)

Initialisiert eine neue Instanz der CookieContainer Klasse mit einem angegebenen Wert für die Anzahl der Cookie Instanzen, die der Container enthalten kann.

Felder

DefaultCookieLengthLimit

Stellt die standardmäßige maximale Größe in Byte der Cookie Instanzen dar, die der CookieContainer enthalten kann. Dieses Feld ist konstant.

DefaultCookieLimit

Stellt die standardmäßige maximale Anzahl von Cookie Instanzen dar, die der CookieContainer enthalten kann. Dieses Feld ist konstant.

DefaultPerDomainCookieLimit

Stellt die standardmäßige maximale Anzahl von Cookie Instanzen dar, auf die der CookieContainer pro Domäne verweisen kann. Dieses Feld ist konstant.

Eigenschaften

Capacity

Ruft die Anzahl der Cookie Instanzen ab, die ein CookieContainer enthalten kann, oder legt diese fest.

Count

Ruft die Anzahl der Cookie Instanzen ab, die ein CookieContainer derzeit enthält.

MaxCookieSize

Stellt die maximal zulässige Länge eines Cookiedar.

PerDomainCapacity

Dient zum Abrufen oder Festlegen der Anzahl von Cookie Instanzen, die ein CookieContainer pro Domäne enthalten kann.

Methoden

Add(Cookie)

Fügt einer CookieContainereine Cookie hinzu. Diese Methode verwendet die Domäne aus dem Cookie, um zu bestimmen, welcher Domänensammlung die Cookie zugeordnet werden soll.

Add(CookieCollection)

Fügt dem CookieContainerden Inhalt einer CookieCollection hinzu.

Add(Uri, Cookie)

Fügt dem CookieContainer für einen bestimmten URI einen Cookie hinzu.

Add(Uri, CookieCollection)

Fügt den Inhalt einer CookieCollection dem CookieContainer für einen bestimmten URI hinzu.

Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
GetAllCookies()

Ruft eine CookieCollection ab, die alle Cookie Instanzen im Container enthält.

GetCookieHeader(Uri)

Ruft den HTTP-Cookieheader ab, der die HTTP-Cookies enthält, die die Cookie Instanzen darstellen, die einem bestimmten URI zugeordnet sind.

GetCookies(Uri)

Ruft eine CookieCollection ab, die die Cookie Instanzen enthält, die einem bestimmten URI zugeordnet sind.

GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
SetCookies(Uri, String)

Fügt Cookie Instanzen für einen oder mehrere Cookies aus einem HTTP-Cookie-Header zum CookieContainer für einen bestimmten URI hinzu.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für:

Weitere Informationen