CookieContainer Třída

Definice

Obor názvů:

System.Net

Sestavení:

netstandard.dll, System.Net.Primitives.dll

Zdroj:

CookieContainer.cs

Poskytuje kontejner pro kolekci CookieCollection objektů.

public ref class CookieContainer

public class CookieContainer

type CookieContainer = class

Public Class CookieContainer

Dědičnost

Object

CookieContainer

Poznámky

A CookieContainer je datová struktura, která poskytuje úložiště pro instance Cookie třídy a která je přístupná způsobem jako databáze. Má CookieContainer limit kapacity, který je nastaven při vytvoření nebo změně kontejneru vlastností.

Instance Cookie třídy se přidá do kontejneru na základě jeho původního identifikátoru URI. Přidá se do interního CookieCollection objektu přidruženého k identifikátoru URI. Z Cookie kontejneru se načte na základě identifikátoru URI jako CookieCollectionřetězce nebo řetězce, který lze použít k odeslání http WebRequests.

Má CookieContainer tři vlastnosti, které řídí objem obsahu kontejneru: Capacity, MaxCookieSizea PerDomainCapacity. Tyto hodnoty mají výchozí nastavení 300, 4096 a 20. Cookie Při přidání do kontejneru se tyto vlastnosti používají k určení, zda Cookie již obsažená v objektu CookieContainer by se měla zahodit, aby se uvolnilo místo pro nový. Udržuje CookieContainer přehled o každém přidání, aby nedošlo Capacity k překročení limitů ani PerDomainCapacity limitů. Pokud dojde k překročení jednoho nebo obojíhoCookie, CookieContainer odeberou se instance, které jsou v nich uloženy. Nejprve se odebere všechna data, jejichž platnost vypršela Cookie . Pokud je nutné znovu využít další kapacitu, vyprázdní se nejméně nedávno použitá CookieCollection kapacita.

Bezpečnost vláken

Metody pro přidávání a načítání Cookie instancí do a z vlákna CookieContainer jsou bezpečné pro přístup z více vláken a lze je používat souběžně z více vláken.

Note

Bez ohledu na bezpečnost vláken může neočekávané sdílení CookieContainer instancí vést k problémům při práci nebo HttpClientHttpClientHandlerSocketsHttpHandler, protože části aplikace, které nejsou určeny ke sdílení souborů cookie s ostatními, to může neúmyslně provést. Nedoporučujeme používat soubory cookie společně s IHttpClientFactory.

Konstruktory

Name	Description
CookieContainer()	Inicializuje novou instanci CookieContainer třídy.
CookieContainer(Int32, Int32, Int32)	Inicializuje novou instanci CookieContainer třídy s konkrétními vlastnostmi.
CookieContainer(Int32)	Inicializuje novou instanci CookieContainer třídy se zadanou hodnotou pro počet Cookie instancí, které kontejner může obsahovat.

Pole

Name	Description
DefaultCookieLengthLimit	Představuje výchozí maximální velikost instancí, které Cookie mohou obsahovat, v bajtechCookieContainer. Toto pole je konstantní.
DefaultCookieLimit	Představuje výchozí maximální počet Cookie instancí, které CookieContainer může obsahovat. Toto pole je konstantní.
DefaultPerDomainCookieLimit	Představuje výchozí maximální počet Cookie instancí, na které CookieContainer lze odkazovat na každou doménu. Toto pole je konstantní.

Vlastnosti

Name	Description
Capacity	Získá nebo nastaví počet Cookie instancí, které CookieContainer může obsahovat.
Count	Získá počet Cookie instancí, které CookieContainer aktuálně obsahuje.
MaxCookieSize	Představuje maximální povolenou délku Cookie.
PerDomainCapacity	Získá nebo nastaví počet Cookie instancí, které CookieContainer může obsahovat na doménu.

Metody

Name	Description
Add(Cookie)	Přidá do Cookie souboru CookieContainer. Tato metoda používá doménu z domény Cookie k určení, ke které kolekci domény chcete přidružit Cookie .
Add(CookieCollection)	Přidá obsah souboru CookieCollectionCookieContainer.
Add(Uri, Cookie)	Cookie Přidá do konkrétního identifikátoru CookieContainer URI.
Add(Uri, CookieCollection)	Přidá obsah konkrétního CookieCollection identifikátoru CookieContainer URI.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetAllCookies()	CookieCollection Získá, který obsahuje všechny Cookie instance v kontejneru.
GetCookieHeader(Uri)	Získá hlavičku souboru cookie HTTP, která obsahuje soubory cookie HTTP, které představují Cookie instance, které jsou přidruženy ke konkrétnímu identifikátoru URI.
GetCookies(Uri)	CookieCollection Získá, který obsahuje Cookie instance, které jsou přidruženy k určitému identifikátoru URI.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
SetCookies(Uri, String)	Přidá Cookie instance pro jeden nebo více souborů cookie z hlavičky souboru cookie HTTP do konkrétního identifikátoru CookieContainer URI.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• Cookie
• CookieCollection
• CookieContainer
• CookieException
• ICollection