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 CookieContainerpublic ref class CookieContainer sealedpublic class CookieContainer[System.Serializable]
public class CookieContainerpublic sealed class CookieContainertype CookieContainer = class[<System.Serializable>]
type CookieContainer = classPublic Class CookieContainerPublic NotInheritable Class CookieContainer- Héritage
-
CookieContainer
- Attributs
Remarques
Il CookieContainer s’agit d’une structure de données qui fournit un stockage pour les instances de la classe, et qui est accessible de manière semblable à la Cookie base de données. La CookieContainer limite de capacité 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 élément interne CookieCollection associé à l’URI. Un Cookie est récupéré à partir du conteneur en fonction de l’URI en tant que CookieCollectionchaîne qui peut être utilisée pour envoyer des requêtes WebRequests HTTP.
Il 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 conteneur est ajouté, ces propriétés sont utilisées pour déterminer si un Cookie élément déjà contenu dans le CookieContainer conteneur doit être ignoré pour en faire place pour le nouveau. Le CookieContainer suivi de chaque ajout permet de s’assurer que ni les PerDomainCapacityCapacity limites ne sont dépassées. Si un ou les deux sont dépassés, Cookie les instances détenues par le CookieContainer fichier sont supprimées. Tout d’abord, toute date d’expiration Cookie est supprimée. Si d’autres capacités doivent être récapiturées, le moins récemment utilisé CookieCollection est vidé.
Sécurité des threads
Les méthodes permettant d’ajouter et de récupérer des Cookie instances vers et à partir d’une CookieContainer instance sont thread-safe et peuvent être utilisées simultanément à partir de plusieurs threads.
Note
Indépendamment de la sécurité des threads, le partage imprévu d’instances peut entraîner des problèmes lors de CookieContainer l’utilisation HttpClient et HttpClientHandler ou SocketsHttpHandler, dans la mesure où des parties de l’application qui ne sont pas destinées à partager des cookies entre elles peuvent éventuellement le faire par inadvertance. Il n’est pas recommandé d’utiliser des cookies avec IHttpClientFactory.
Constructeurs
| Nom | Description |
|---|---|
| CookieContainer() |
Initialise une nouvelle instance de la classe CookieContainer. |
| CookieContainer(Int32, Int32, Int32) |
Initialise une nouvelle instance de la CookieContainer classe avec des propriétés spécifiques. |
| CookieContainer(Int32) |
Initialise une nouvelle instance de la CookieContainer classe avec une valeur spécifiée pour le nombre d’instances Cookie que le conteneur peut contenir. |
Champs
| Nom | Description |
|---|---|
| DefaultCookieLengthLimit |
Représente la taille maximale par défaut, en octets, des Cookie instances que la CookieContainer capacité peut contenir. Ce champ est constant. |
| DefaultCookieLimit |
Représente le nombre maximal d’instances Cookie par défaut qu’il CookieContainer peut contenir. Ce champ est constant. |
| DefaultPerDomainCookieLimit |
Représente le nombre maximal d’instances Cookie par défaut que l’instance CookieContainer peut référencer par domaine. Ce champ est constant. |
Propriétés
| Nom | Description |
|---|---|
| Capacity |
Obtient ou définit le nombre d’instances Cookie qu’un CookieContainer peut contenir. |
| Count |
Obtient le nombre d’instances Cookie qu’une instance CookieContainer contient actuellement. |
| MaxCookieSize |
Représente la longueur maximale autorisée d’un Cookie. |
| PerDomainCapacity |
Obtient ou définit le nombre d’instances Cookie qu’un CookieContainer domaine peut contenir. |
Méthodes
| Nom | Description |
|---|---|
| Add(Cookie) |
Ajoute un Cookie à un CookieContainer. Cette méthode utilise le domaine à partir du Cookie pour déterminer la collection de domaines à associer Cookie . |
| Add(CookieCollection) |
Ajoute le contenu d’un CookieCollection à l’objet CookieContainer. |
| Add(Uri, Cookie) |
Ajoute un Cookie à l’URI CookieContainer particulier. |
| Add(Uri, CookieCollection) |
Ajoute le contenu d’un CookieCollection uri CookieContainer particulier. |
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| GetCookieHeader(Uri) |
Obtient l’en-tête de cookie HTTP qui contient les cookies HTTP qui représentent les Cookie instances associées à un URI spécifique. |
| GetCookies(Uri) |
Obtient un CookieCollection qui contient les Cookie instances 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 des instances pour un ou plusieurs cookies d’un en-tête de cookie HTTP à l’URI CookieContainer spécifique. |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |