CookieContainer Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Biedt een container voor een verzameling CookieCollection objecten.
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- Overname
-
CookieContainer
- Kenmerken
Opmerkingen
Een CookieContainer is een gegevensstructuur die opslag biedt voor exemplaren van de Cookie klasse en die op een databaseachtige manier wordt geopend. De CookieContainer capaciteitslimiet is ingesteld wanneer de container wordt gemaakt of gewijzigd door een eigenschap.
Er wordt een exemplaar van de Cookie klasse toegevoegd aan de container op basis van de oorspronkelijke URI. Deze wordt toegevoegd aan een interne CookieCollection gekoppelde URI. Een Cookie wordt opgehaald uit de container op basis van de URI als een CookieCollection, of als een tekenreeks die kan worden gebruikt om HTTP WebRequests te verzenden.
De CookieContainer heeft drie eigenschappen die het volume van de inhoud van de container bepalen: Capacity, MaxCookieSizeen PerDomainCapacity. Deze waarden hebben respectievelijk de standaardinstellingen 300, 4096 en 20. Wanneer er een Cookie wordt toegevoegd aan de container, worden deze eigenschappen gebruikt om te bepalen of een Cookie al opgenomen in de CookieContainer container moet worden verwijderd om ruimte te maken voor de nieuwe. De CookieContainer toevoeging houdt elke toevoeging bij om ervoor te zorgen dat noch de PerDomainCapacityCapacity limieten worden overschreden. Als een of beide worden overschreden, Cookie worden instanties die door de CookieContainer instantie worden bewaard, verwijderd. Eerst worden alle verlopen items Cookie verwijderd. Als verdere capaciteit opnieuw moet worden ingekapseld, wordt de minst recent gebruikte CookieCollection capaciteit opgeschoond.
Schroefdraadveiligheid
De methoden voor het toevoegen en ophalen Cookie van exemplaren van en naar een CookieContainer thread-veilig en kunnen gelijktijdig worden gebruikt vanuit meerdere threads.
Note
Ongeacht thread-veiligheid kan onverwacht delen van CookieContainer exemplaren leiden tot problemen bij het werken met HttpClient en HttpClientHandler of SocketsHttpHandler, omdat delen van de toepassing die niet zijn bedoeld om cookies met elkaar te delen, dit per ongeluk kunnen doen. Het wordt niet aanbevolen om cookies samen met IHttpClientFactory.
Constructors
| Name | Description |
|---|---|
| CookieContainer() |
Initialiseert een nieuw exemplaar van de CookieContainer klasse. |
| CookieContainer(Int32, Int32, Int32) |
Initialiseert een nieuw exemplaar van de CookieContainer klasse met specifieke eigenschappen. |
| CookieContainer(Int32) |
Initialiseert een nieuw exemplaar van de CookieContainer klasse met een opgegeven waarde voor het aantal Cookie exemplaren dat de container kan bevatten. |
Velden
| Name | Description |
|---|---|
| DefaultCookieLengthLimit |
Vertegenwoordigt de standaard maximale grootte, in bytes, van de Cookie exemplaren die de CookieContainer container kan bevatten. Dit veld is constant. |
| DefaultCookieLimit |
Vertegenwoordigt het standaard maximum aantal Cookie exemplaren dat de CookieContainer container kan bevatten. Dit veld is constant. |
| DefaultPerDomainCookieLimit |
Hiermee geeft u het standaard maximum aantal Cookie exemplaren aan waarnaar per CookieContainer domein kan worden verwezen. Dit veld is constant. |
Eigenschappen
| Name | Description |
|---|---|
| Capacity |
Hiermee haalt u het aantal Cookie exemplaren op of CookieContainer stelt u dit in. |
| Count |
Hiermee haalt u het aantal Cookie exemplaren op dat momenteel wordt CookieContainer opgeslagen. |
| MaxCookieSize |
Vertegenwoordigt de maximaal toegestane lengte van een Cookie. |
| PerDomainCapacity |
Hiermee haalt u het aantal Cookie exemplaren op dat per CookieContainer domein kan worden opgeslagen of ingesteld. |
Methoden
| Name | Description |
|---|---|
| Add(Cookie) |
Voegt een Cookie toe aan een CookieContainer. Deze methode gebruikt het domein van de Cookie site om te bepalen aan welke domeinverzameling de Cookie verzameling moet worden gekoppeld. |
| Add(CookieCollection) |
Hiermee voegt u de inhoud van een CookieCollection bestand toe aan de CookieContainer. |
| Add(Uri, Cookie) |
Hiermee voegt u een Cookie aan de CookieContainer voor een bepaalde URI toe. |
| Add(Uri, CookieCollection) |
Hiermee wordt de inhoud van een CookieCollection aan de CookieContainer voor een bepaalde URI toegevoegd. |
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| GetCookieHeader(Uri) |
Haalt de HTTP-cookieheader op die de HTTP-cookies bevat die de Cookie exemplaren vertegenwoordigen die zijn gekoppeld aan een specifieke URI. |
| GetCookies(Uri) |
Hiermee haalt u een CookieCollection op met de Cookie exemplaren die zijn gekoppeld aan een specifieke URI. |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| SetCookies(Uri, String) |
Voegt Cookie instanties voor een of meer cookies van een HTTP-cookieheader toe aan de CookieContainer voor een specifieke URI. |
| ToString() |
Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object) |