CookieContainer CookieContainer CookieContainer CookieContainer Class

Définition

Fournit un conteneur pour une collection d'objets CookieCollection.Provides a container for a collection of CookieCollection objects.

public ref class CookieContainer
[System.Serializable]
public class CookieContainer
type CookieContainer = class
Public Class CookieContainer
Héritage
CookieContainerCookieContainerCookieContainerCookieContainer
Attributs

Remarques

Un CookieContainer est une structure de données qui fournit le stockage pour les Cookie instances de la classe et qui est accessible de manière similaire à une base de données.A CookieContainer is a data structure that provides storage for instances of the Cookie class, and which is accessed in a database-like manner. CookieContainer A une limite de capacité définie quand le conteneur est créé ou modifié par une propriété.The CookieContainer has a capacity limit that is set when the container is created or changed by a property.

Une instance de la Cookie classe est ajoutée au conteneur en fonction de son URI d’origine.An instance of the Cookie class is added to the container based on its originating URI. Elle est ajoutée à un interne CookieCollection associé à l’URI.It is added to an internal CookieCollection associated with the URI. Un Cookie est récupéré à partir du conteneur en fonction de l’URI CookieCollectionen tant que, ou sous la forme d’une chaîne qui peut être utilisée pour envoyer des requêtes WebRequest http.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.

Le CookieContainer a trois propriétés qui régissent le volume du contenu du conteneur : Capacity, MaxCookieSizeet PerDomainCapacity.The CookieContainer has three properties that govern the volume of the content of the container: Capacity, MaxCookieSize, and PerDomainCapacity. Ces valeurs ont respectivement les paramètres par défaut 300, 4096 et 20.These values have the default settings of 300, 4096, and 20 respectively. Lorsqu’un Cookie est ajouté au conteneur, ces propriétés sont utilisées pour déterminer si un Cookie déjà contenu dans CookieContainer doit être ignoré pour libérer de l’espace pour le nouveau.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. Le CookieContainer effectue le suivi de chaque ajout pour s’assurer que Capacity ni les PerDomainCapacity limites ni les limites ne sont dépassées.The CookieContainer keeps track of each addition to ensure that neither the Capacity nor the PerDomainCapacity limits are exceeded. Si l’une ou les deux sont dépassées, Cookie les instances détenues par le CookieContainer sont supprimées.If one or both are exceeded, then Cookie instances held by the CookieContainer are removed. Tout d’abord, Cookie l’expiration est supprimée.First, any expired Cookie is removed. Si une capacité supplémentaire doit être recapturée, la dernière utilisation utilisée CookieCollection est purgée.If further capacity must be recaptured, then the least-recently used CookieCollection is purged.

Constructeurs

CookieContainer() CookieContainer() CookieContainer() CookieContainer()

Initialise une nouvelle instance de la classe CookieContainer.Initializes a new instance of the CookieContainer class.

CookieContainer(Int32) CookieContainer(Int32) CookieContainer(Int32) CookieContainer(Int32)

Initialise une nouvelle instance de la classe CookieContainer avec une valeur spécifiée pour le nombre d'instances Cookie que le conteneur peut recevoir.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) CookieContainer(Int32, Int32, Int32) CookieContainer(Int32, Int32, Int32) CookieContainer(Int32, Int32, Int32)

Initialise une nouvelle instance de la classe CookieContainer avec des propriétés spécifiques.Initializes a new instance of the CookieContainer class with specific properties.

Champs

DefaultCookieLengthLimit DefaultCookieLengthLimit DefaultCookieLengthLimit DefaultCookieLengthLimit

Représente la taille maximale par défaut, en octets, des instances de Cookie que CookieContainer peut recevoir.Represents the default maximum size, in bytes, of the Cookie instances that the CookieContainer can hold. Ce champ est constant.This field is constant.

DefaultCookieLimit DefaultCookieLimit DefaultCookieLimit DefaultCookieLimit

Représente le nombre maximal par défaut d'instances de Cookie que CookieContainer peut recevoir.Represents the default maximum number of Cookie instances that the CookieContainer can hold. Ce champ est constant.This field is constant.

DefaultPerDomainCookieLimit DefaultPerDomainCookieLimit DefaultPerDomainCookieLimit DefaultPerDomainCookieLimit

Représente le nombre maximal par défaut d'instances de Cookie que CookieContainer peut référencer par domaine.Represents the default maximum number of Cookie instances that the CookieContainer can reference per domain. Ce champ est constant.This field is constant.

Propriétés

Capacity Capacity Capacity Capacity

Obtient ou définit le nombre d’instances de Cookie que CookieContainer peut contenir.Gets or sets the number of Cookie instances that a CookieContainer can hold.

Count Count Count Count

Obtient le nombre d'instances de Cookie que CookieContainer contient actuellement.Gets the number of Cookie instances that a CookieContainer currently holds.

MaxCookieSize MaxCookieSize MaxCookieSize MaxCookieSize

Représente la longueur maximale autorisée de Cookie.Represents the maximum allowed length of a Cookie.

PerDomainCapacity PerDomainCapacity PerDomainCapacity PerDomainCapacity

Obtient ou définit le nombre d’instances de Cookie que CookieContainer peut contenir par domaine.Gets or sets the number of Cookie instances that a CookieContainer can hold per domain.

Méthodes

Add(Cookie) Add(Cookie) Add(Cookie) Add(Cookie)

Ajoute un Cookie à un CookieContainer.Adds a Cookie to a CookieContainer. Cette méthode utilise le domaine de Cookie pour déterminer à quelle collection de domaine il convient d'associer Cookie.This method uses the domain from the Cookie to determine which domain collection to associate the Cookie with.

Add(CookieCollection) Add(CookieCollection) Add(CookieCollection) Add(CookieCollection)

Ajoute le contenu de CookieCollection à CookieContainer.Adds the contents of a CookieCollection to the CookieContainer.

Add(Uri, Cookie) Add(Uri, Cookie) Add(Uri, Cookie) Add(Uri, Cookie)

Ajoute Cookie au CookieContainer d'un URI particulier.Adds a Cookie to the CookieContainer for a particular URI.

Add(Uri, CookieCollection) Add(Uri, CookieCollection) Add(Uri, CookieCollection) Add(Uri, CookieCollection)

Ajoute le contenu de CookieCollection au CookieContainer d'un URI particulier.Adds the contents of a CookieCollection to the CookieContainer for a particular URI.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetCookieHeader(Uri) GetCookieHeader(Uri) GetCookieHeader(Uri) GetCookieHeader(Uri)

Obtient l'en-tête cookie HTTP qui contient les cookies HTTP représentant les instances de Cookie qui sont associées à un URI spécifique.Gets the HTTP cookie header that contains the HTTP cookies that represent the Cookie instances that are associated with a specific URI.

GetCookies(Uri) GetCookies(Uri) GetCookies(Uri) GetCookies(Uri)

Obtient un CookieCollection qui contient les instances de Cookie qui sont associées à un URI spécifique.Gets a CookieCollection that contains the Cookie instances that are associated with a specific URI.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
SetCookies(Uri, String) SetCookies(Uri, String) SetCookies(Uri, String) SetCookies(Uri, String)

Ajoute des instances de Cookie pour un ou plusieurs cookies d'un en-tête cookie HTTP au CookieContainer d'un URI spécifique.Adds Cookie instances for one or more cookies from an HTTP cookie header to the CookieContainer for a specific URI.

ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)

S’applique à

Voir aussi