CookieContainer Osztály
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Tárolót biztosít objektumok gyűjteményéhez 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- Öröklődés
-
CookieContainer
- Attribútumok
Megjegyzések
Az A CookieContainer egy olyan adatstruktúra, amely az osztály példányai Cookie számára biztosít tárhelyet, és amely adatbázis-szerű módon érhető el. A CookieContainer tároló kapacitáskorlátja akkor van beállítva, amikor a tárolót egy tulajdonság hozza létre vagy módosítja.
A rendszer hozzáadja az Cookie osztály egy példányát a tárolóhoz a kiinduló URI alapján. A rendszer hozzáadja az URI-hoz társított belső CookieCollection fájlhoz. A Cookie rendszer lekéri a tárolóból az URI CookieCollectionalapján, vagy sztringként, amely a HTTP WebRequests elküldéséhez használható.
A CookieContainer tároló tartalmának mennyiségét három tulajdonság szabályozza: Capacity, MaxCookieSizeés PerDomainCapacity. Ezek az értékek az alapértelmezett beállítások: 300, 4096, illetve 20. Amikor hozzáad egy Cookie tárolót, ezek a tulajdonságok határozzák meg, hogy a Cookie tárolóban lévő elemeket CookieContainer el kell-e vetni, hogy helyet biztosítsunk az újnak. Az CookieContainer egyes kiegészítések nyomon követése annak biztosítása érdekében, hogy sem a Capacity korlátokat, sem a PerDomainCapacity korlátokat nem lépik túl. Ha valamelyiket vagy mindkettőt túllépi, akkor Cookie a rendszer eltávolítja az CookieContainer általa tárolt példányokat. Először minden lejárt Cookie el lesz távolítva. Ha további kapacitást kell visszafoglalni, akkor a legkevésbé használt CookieCollection kapacitás törlődik.
Szálbiztonság
A példányok egybe- és onnan Cookie való CookieContainer hozzáadásának és lekérésének módszerei szálbiztosak, és egyidejűleg több szálból is használhatók.
Note
A szálbiztonságtól függetlenül a példányok nem várt megosztása CookieContainer problémákat okozhat a használat során HttpClient , és HttpClientHandlerSocketsHttpHandlermivel az alkalmazás azon részei, amelyek nem célja a cookie-k megosztása egymással, véletlenül is előfordulhatnak. Nem ajánlott a cookie-kat együtt használni.IHttpClientFactory
Konstruktorok
| Name | Description |
|---|---|
| CookieContainer() |
Inicializálja a CookieContainer osztály új példányát. |
| CookieContainer(Int32, Int32, Int32) |
Inicializálja az osztály új példányát CookieContainer adott tulajdonságokkal. |
| CookieContainer(Int32) |
Inicializálja az CookieContainer osztály új példányát a tároló által tartható példányok számának Cookie megadott értékével. |
Mezők
| Name | Description |
|---|---|
| DefaultCookieLengthLimit |
A megtartható példányok Cookie alapértelmezett maximális mérete bájtban CookieContainer kifejezve. Ez a mező állandó. |
| DefaultCookieLimit |
A megtartható példányok Cookie alapértelmezett maximális számát CookieContainer jelöli. Ez a mező állandó. |
| DefaultPerDomainCookieLimit |
A tartományonként hivatkozható példányok Cookie alapértelmezett maximális számát CookieContainer jelöli. Ez a mező állandó. |
Tulajdonságok
| Name | Description |
|---|---|
| Capacity |
Lekéri vagy beállítja Cookie a megtartható példányok CookieContainer számát. |
| Count |
Lekéri az aktuálisan birtokolt Cookie példányok számátCookieContainer. |
| MaxCookieSize |
A maximálisan megengedett hosszt Cookiejelöli. |
| PerDomainCapacity |
Lekéri vagy beállítja Cookie az egy tartományra jutó példányok CookieContainer számát. |
Metódusok
| Name | Description |
|---|---|
| Add(Cookie) |
Ad hozzá egy Cookie .CookieContainer Ez a metódus a tartományt használja a Cookie tartományból annak meghatározására, hogy melyik tartománycsoporthoz szeretné társítani a tartományt Cookie . |
| Add(CookieCollection) |
Hozzáadja egy fájl CookieCollection tartalmát a CookieContainer. |
| Add(Uri, Cookie) |
Hozzáad egy CookieCookieContainer adott URI-t. |
| Add(Uri, CookieCollection) |
Hozzáadja egy adott CookieCollection URI tartalmát az CookieContainer adott URI-hoz. |
| Equals(Object) |
Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object) |
| GetAllCookies() |
CookieCollection Lekéri a tároló összes Cookie példányát tartalmazó példányt. |
| GetCookieHeader(Uri) |
Lekéri az adott URI-hoz társított példányokat képviselő Cookie HTTP-cookie-k fejlécét. |
| GetCookies(Uri) |
CookieCollection Lekéri azokat a Cookie példányokat, amelyek egy adott URI-hoz vannak társítva. |
| GetHashCode() |
Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object) |
| GetType() |
Lekéri az Type aktuális példányt. (Öröklődés forrása Object) |
| MemberwiseClone() |
Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object) |
| SetCookies(Uri, String) |
Egy vagy több cookie-példányt ad Cookie hozzá egy HTTP-cookie fejlécéből egy CookieContainer adott URI-hoz. |
| ToString() |
Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object) |
