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
A CookieContainer est une structure de données qui fournit un stockage pour les instances de la Cookie classe et qui est accessible de manière semblable à celle d’une base de données. a CookieContainer une limite de capacité qui est définie lorsque le conteneur est créé ou modifié par une propriété.
Une instance de la Cookie classe est ajoutée au conteneur en fonction de son URI d’origine. Il est ajouté à un interne CookieCollection associé à l’URI. Un Cookie est récupéré à partir du conteneur en fonction de l’URI en tant que CookieCollection, ou en tant que chaîne qui peut être utilisée pour envoyer des webrequests HTTP.
a CookieContainer trois propriétés qui régissent le volume du contenu du conteneur : Capacity, MaxCookieSizeet PerDomainCapacity. Ces valeurs ont les paramètres par défaut de 300, 4096 et 20 respectivement. Quand un Cookie est ajouté au conteneur, ces propriétés sont utilisées pour déterminer si un Cookie déjà contenu dans le CookieContainer doit être ignoré pour faire de la place pour le nouveau. Le CookieContainer effectue le suivi de chaque ajout pour s’assurer que ni les CapacityPerDomainCapacity limites ni ne sont dépassées. Si l’un ou les deux sont dépassés, Cookie les instances détenues par le CookieContainer sont supprimées. Tout d’abord, toute date d’expiration Cookie est supprimée. Si une capacité supplémentaire doit être récupérée, le moins récemment utilisé CookieCollection est vidé.
Constructeurs
CookieContainer() |
Initialise une nouvelle instance de la classe CookieContainer. |
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. |
CookieContainer(Int32, Int32, Int32) |
Initialise une nouvelle instance de la classe CookieContainer avec des propriétés spécifiques. |
Champs
DefaultCookieLengthLimit |
Représente la taille maximale par défaut, en octets, des instances de Cookie que CookieContainer peut recevoir. Ce champ est constant. |
DefaultCookieLimit |
Représente le nombre maximal par défaut d'instances de Cookie que CookieContainer peut recevoir. Ce champ est constant. |
DefaultPerDomainCookieLimit |
Représente le nombre maximal par défaut d'instances de Cookie que CookieContainer peut référencer par domaine. Ce champ est constant. |
Propriétés
Capacity |
Obtient ou définit le nombre d’instances de Cookie que CookieContainer peut contenir. |
Count |
Obtient le nombre d'instances de Cookie que CookieContainer contient actuellement. |
MaxCookieSize |
Représente la longueur maximale autorisée de Cookie. |
PerDomainCapacity |
Obtient ou définit le nombre d’instances de Cookie que CookieContainer peut contenir par domaine. |
Méthodes
Add(Cookie) |
Ajoute un Cookie à un CookieContainer. Cette méthode utilise le domaine de Cookie pour déterminer à quelle collection de domaine il convient d'associer Cookie. |
Add(CookieCollection) |
Ajoute le contenu de CookieCollection à CookieContainer. |
Add(Uri, Cookie) |
Ajoute Cookie au CookieContainer d'un URI particulier. |
Add(Uri, CookieCollection) |
Ajoute le contenu de 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 un CookieCollection qui contient toutes les Cookie instances du conteneur. |
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. |
GetCookies(Uri) |
Obtient un CookieCollection qui contient les instances de Cookie qui sont associées à un URI spécifique. |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
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. |
ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |