CookieContainer Class

Definition

Stellt einen Container für eine Auflistung von CookieCollection-Objekten bereit.Provides a container for a collection of CookieCollection objects.

public ref class CookieContainer
public ref class CookieContainer sealed
public class CookieContainer
[System.Serializable]
public class CookieContainer
public sealed class CookieContainer
type CookieContainer = class
Public Class CookieContainer
Public NotInheritable Class CookieContainer
Inheritance
CookieContainer
Attributes

Remarks

Bei einem CookieContainer handelt es sich um eine Datenstruktur, die Speicher für Instanzen der Cookie-Klasse bereitstellt und auf die Daten Bank ähnliche Weise aufgerufen wird.A CookieContainer is a data structure that provides storage for instances of the Cookie class, and which is accessed in a database-like manner. Der CookieContainer verfügt über ein Kapazitäts Limit, das festgelegt wird, wenn der Container von einer Eigenschaft erstellt oder geändert wird.The CookieContainer has a capacity limit that is set when the container is created or changed by a property.

Eine Instanz der Cookie-Klasse wird dem Container basierend auf dem ursprünglichen URI hinzugefügt.An instance of the Cookie class is added to the container based on its originating URI. Sie wird einem internen CookieCollection hinzugefügt, das dem URI zugeordnet ist.It is added to an internal CookieCollection associated with the URI. Ein Cookie wird aus dem Container auf der Grundlage des URI als CookieCollectionoder als Zeichenfolge abgerufen, die zum Senden von HTTP-WebRequests verwendet werden kann.A Cookie is retrieved from the container based on the URI as a CookieCollection, or as a string that can be used to submit HTTP WebRequests.

Der CookieContainer verfügt über drei Eigenschaften, die das Volume des Inhalts des Containers Steuern: Capacity, MaxCookieSizeund PerDomainCapacity.The CookieContainer has three properties that govern the volume of the content of the container: Capacity, MaxCookieSize, and PerDomainCapacity. Diese Werte haben die Standardeinstellungen von 300, 4096 und 20 bzw.These values have the default settings of 300, 4096, and 20 respectively. Wenn ein Cookie dem Container hinzugefügt wird, werden diese Eigenschaften verwendet, um zu bestimmen, ob ein Cookie, das bereits in der CookieContainer enthalten ist, verworfen werden soll, um Platz für den neuen zu schaffen.When a Cookie is added to the container, these properties are used to determine whether a Cookie already contained in the CookieContainer should be discarded to make room for the new one. Der CookieContainer verfolgt jede Addition nach, um sicherzustellen, dass weder die Capacity noch die PerDomainCapacity Limits überschritten werden.The CookieContainer keeps track of each addition to ensure that neither the Capacity nor the PerDomainCapacity limits are exceeded. Wenn eine oder beide überschritten werden, werden Cookie von der CookieContainer gehaltenen Instanzen entfernt.If one or both are exceeded, then Cookie instances held by the CookieContainer are removed. Zuerst werden alle abgelaufenen Cookie entfernt.First, any expired Cookie is removed. Wenn weitere Kapazität wieder hergestellt werden muss, wird die am wenigsten zuletzt verwendete CookieCollection bereinigt.If further capacity must be recaptured, then the least-recently used CookieCollection is purged.

Constructors

CookieContainer()

Initialisiert eine neue Instanz der CookieContainer-Klasse.Initializes a new instance of the CookieContainer class.

CookieContainer(Int32)

Initialisiert eine neue Instanz der CookieContainer-Klasse mit einem angegebenen Wert für die Anzahl von Cookie-Instanzen, die der Container enthalten kann.Initializes a new instance of the CookieContainer class with a specified value for the number of Cookie instances that the container can hold.

CookieContainer(Int32, Int32, Int32)

Initialisiert eine neue Instanz der CookieContainer-Klasse mit bestimmten Eigenschaften.Initializes a new instance of the CookieContainer class with specific properties.

Fields

DefaultCookieLengthLimit

Stellt den Standardwert für die maximale Größe der Cookie-Instanzen, die der CookieContainer enthalten kann, in Bytes dar.Represents the default maximum size, in bytes, of the Cookie instances that the CookieContainer can hold. Dieses Feld ist konstant.This field is constant.

DefaultCookieLimit

Stellt den Standardwert für die maximale Anzahl von Cookie-Instanzen dar, die der CookieContainer enthalten kann.Represents the default maximum number of Cookie instances that the CookieContainer can hold. Dieses Feld ist konstant.This field is constant.

DefaultPerDomainCookieLimit

Stellt den Standardwert für die maximale Anzahl von Cookie-Instanzen dar, auf die der CookieContainer pro Domäne verweisen kann.Represents the default maximum number of Cookie instances that the CookieContainer can reference per domain. Dieses Feld ist konstant.This field is constant.

Properties

Capacity

Ruft die Anzahl von Cookie-Instanzen ab, die CookieContainer enthalten kann, oder legt diese fest.Gets or sets the number of Cookie instances that a CookieContainer can hold.

Count

Ruft die Anzahl der Cookie-Instanzen ab, die ein CookieContainer derzeit enthält.Gets the number of Cookie instances that a CookieContainer currently holds.

MaxCookieSize

Stellt die maximal zulässige Länge eines Cookie dar.Represents the maximum allowed length of a Cookie.

PerDomainCapacity

Ruft die Anzahl von Cookie-Instanzen ab, die CookieContainer pro Domäne enthalten kann, oder legt diese fest.Gets or sets the number of Cookie instances that a CookieContainer can hold per domain.

Methods

Add(Cookie)

Fügt einer CookieContainer eine Cookie 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.

Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetCookieHeader(Uri)

Ruft den HTTP-Cookieheader mit den HTTP-Cookies ab, die die einem bestimmten URI zugeordneten Cookie-Instanzen darstellen.Gets the HTTP cookie header that contains the HTTP cookies that represent the Cookie instances that are associated with a specific URI.

GetCookies(Uri)

Ruft eine CookieCollection mit den Cookie-Instanzen ab, die einem bestimmten URI zugeordnet sind.Gets a CookieCollection that contains the Cookie instances that are associated with a specific URI.

GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
SetCookies(Uri, String)

Fügt dem Cookie für einen angegebenen URI die CookieContainer-Instanzen für Cookies aus einem HTTP-Cookieheader hinzu.Adds Cookie instances for one or more cookies from an HTTP cookie header to the CookieContainer for a specific URI.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Applies to

See also