CookieContainer Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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) |