CookieContainer-Klasse

Artikel
08/20/2007

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

Namespace: System.Net
Assembly: System (in system.dll)

Syntax

'Declaration
<SerializableAttribute> _
Public Class CookieContainer
'Usage
Dim instance As CookieContainer

[SerializableAttribute] 
public class CookieContainer

[SerializableAttribute] 
public ref class CookieContainer

/** @attribute SerializableAttribute() */ 
public class CookieContainer

SerializableAttribute 
public class CookieContainer

Hinweise

Ein CookieContainer ist eine Datenstruktur, in der Instanzen der Cookie-Klasse gespeichert werden können und auf die wie auf eine Datenbank zugegriffen wird. Der CookieContainer besitzt eine Kapazitätsgrenze, die beim Erstellen des Containers festgelegt wird oder durch eine Eigenschaft geändert werden kann.

Dem Container wird eine Instanz der Cookie-Klasse auf der Grundlage des Ursprungs-URI hinzugefügt. Die Instanz wird einer internen CookieCollection hinzugefügt, die dem URI zugeordnet ist. Ein Cookie wird anhand des URI als CookieCollection aus dem Container abgerufen, oder das Cookie wird als Zeichenfolge abgerufen, die zum Senden von HTTP WebRequests verwendet werden kann.

Der CookieContainer verfügt über drei Eigenschaften, mit denen der Umfang des Containerinhalts gesteuert werden kann: Capacity, MaxCookieSize und PerDomainCapacity. Die Standardeinstellung dieser Werte ist jeweils 300, 4096 bzw. 20. Beim Hinzufügen eines Cookie zum Container wird anhand dieser Eigenschaften bestimmt, ob ein im CookieContainer bereits vorhandenes Cookie verworfen werden muss, um Platz für das neue Cookie zu schaffen. Der CookieContainer verfolgt die einzelnen Hinzufügungen, um sicherzustellen, dass weder die Capacity-Beschränkung noch die PerDomainCapacity-Beschränkung überschritten wird. Im Fall einer Überschreitung werden Cookie-Instanzen entfernt, die im CookieContainer gespeichert sind. Zunächst werden abgelaufene Cookie-Instanzen entfernt. Wenn weitere Kapazitäten freigegeben werden müssen, wird die CookieCollection geleert, die am längsten nicht verwendet wurde.

Vererbungshierarchie

System.Object
System.Net.CookieContainer

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

CookieContainer-Member
System.Net-Namespace
Cookie-Klasse
CookieCollection-Klasse
CookieContainer-Klasse
CookieException
ICollection

Freigeben über