CookieContainer Classe

Définition

Fournit un conteneur pour une collection d’objets CookieCollection.

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
Héritage
CookieContainer
Attributs

Remarques

Une CookieContainer est une structure de données qui fournit un stockage pour les instances de la classe Cookie et qui est accessible de manière semblable à la base de données. Le CookieContainer a une limite de capacité définie lorsque le conteneur est créé ou modifié par une propriété.

Une instance de la classe Cookie est ajoutée au conteneur en fonction de son URI d’origine. Il est ajouté à un CookieCollection interne associé à l’URI. Une Cookie est récupérée à partir du conteneur en fonction de l’URI sous la forme d’un CookieCollection, ou sous forme de chaîne qui peut être utilisée pour envoyer des requêtes WEB HTTP.

Le CookieContainer a trois propriétés qui régissent le volume du contenu du conteneur : Capacity, MaxCookieSizeet PerDomainCapacity. Ces valeurs ont respectivement les paramètres par défaut 300, 4096 et 20. Lorsqu’un Cookie est ajouté au conteneur, ces propriétés sont utilisées pour déterminer si une Cookie déjà contenue dans l'CookieContainer doit être ignorée pour en faire place pour la nouvelle. Le CookieContainer effectue le suivi de chaque ajout pour s’assurer que ni les Capacity ni les limites de PerDomainCapacity ne sont dépassées. Si un ou les deux sont dépassés, Cookie instances détenues par le CookieContainer sont supprimées. Tout d’abord, toute Cookie expirée est supprimée. Si une capacité supplémentaire doit être récapitule, la CookieCollection la moins récemment utilisée est vidée.

Constructeurs

CookieContainer()

Initialise une nouvelle instance de la classe CookieContainer.

CookieContainer(Int32, Int32, Int32)

Initialise une nouvelle instance de la classe CookieContainer avec des propriétés spécifiques.

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 contenir.

Champs

DefaultCookieLengthLimit

Représente la taille maximale par défaut, en octets, des instances Cookie que le CookieContainer peut contenir. Ce champ est constant.

DefaultCookieLimit

Représente le nombre maximal par défaut d’instances Cookie que le CookieContainer peut contenir. Ce champ est constant.

DefaultPerDomainCookieLimit

Représente le nombre maximal par défaut d’instances Cookie que le CookieContainer peut référencer par domaine. Ce champ est constant.

Propriétés

Capacity

Obtient ou définit le nombre d’instances Cookie qu’un CookieContainer peut contenir.

Count

Obtient le nombre d’instances Cookie qu’un CookieContainer contient actuellement.

MaxCookieSize

Représente la longueur maximale autorisée d’une Cookie.

PerDomainCapacity

Obtient ou définit le nombre d’instances Cookie qu’un CookieContainer peut contenir par domaine.

Méthodes

Add(Cookie)

Ajoute un Cookie à un CookieContainer. Cette méthode utilise le domaine de l'Cookie pour déterminer la collection de domaines à laquelle associer le Cookie.

Add(CookieCollection)

Ajoute le contenu d’un CookieCollection au CookieContainer.

Add(Uri, Cookie)

Ajoute un Cookie au CookieContainer d’un URI particulier.

Add(Uri, CookieCollection)

Ajoute le contenu d’un CookieCollection au CookieContainer d’un URI particulier.

Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
GetAllCookies()

Obtient une CookieCollection qui contient toutes les instances Cookie dans le conteneur.

GetCookieHeader(Uri)

Obtient l’en-tête de cookie HTTP qui contient les cookies HTTP qui représentent les instances Cookie associées à un URI spécifique.

GetCookies(Uri)

Obtient un CookieCollection qui contient les instances Cookie associées à un URI spécifique.

GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
SetCookies(Uri, String)

Ajoute Cookie instances pour un ou plusieurs cookies d’un en-tête de cookie HTTP à l'CookieContainer d’un URI spécifique.

ToString()

Retourne une chaîne qui représente l’objet actuel.

(Hérité de Object)

S’applique à

Voir aussi