CookieContainer Klasse
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.
Stellt einen Container für eine Auflistung von CookieCollection -Objekten bereit.
public ref class CookieContainerpublic ref class CookieContainer sealedpublic class CookieContainer[System.Serializable]
public class CookieContainerpublic sealed class CookieContainertype CookieContainer = class[<System.Serializable>]
type CookieContainer = classPublic Class CookieContainerPublic 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) |
