CookieContainer Klass

Definition

Namnområde:
System.Net
Sammansättningar:
System.dll, System.Net.Primitives.dll
Sammansättning:
System.dll
Sammansättning:
System.Net.Primitives.dll
Sammansättning:
netstandard.dll

Tillhandahåller en container för en samling CookieCollection objekt.

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
Arv
Object
CookieContainer
Attribut
SerializableAttribute

Kommentarer

A CookieContainer är en datastruktur som tillhandahåller lagring för instanser av Cookie klassen och som används på ett databasliknande sätt. CookieContainer Har en kapacitetsgräns som anges när containern skapas eller ändras av en egenskap.

En instans av Cookie klassen läggs till i containern baserat på dess ursprungliga URI. Den läggs till i en intern CookieCollection associerad med URI:n. A Cookie hämtas från containern baserat på URI:n som en CookieCollection, eller som en sträng som kan användas för att skicka HTTP WebRequests.

CookieContainer Har tre egenskaper som styr volymen för innehållet i containern: Capacity, MaxCookieSizeoch PerDomainCapacity. Dessa värden har standardinställningarna 300, 4096 respektive 20. När en Cookie läggs till i containern används dessa egenskaper för att avgöra om en Cookie som redan finns i CookieContainer ska tas bort för att göra plats för den nya. Håller CookieContainer reda på varje tillägg för att säkerställa att varken Capacity gränserna eller PerDomainCapacity överskrids. Om en eller båda överskrids Cookie tas instanser som innehas av CookieContainer tas bort. Först tas alla utgångna Cookie bort. Om ytterligare kapacitet måste återerövras rensas den senast använda CookieCollection kapaciteten.

Trådsäkerhet

Metoderna för att lägga till och hämta Cookie instanser till och från en CookieContainer är trådsäkra och kan användas samtidigt från flera trådar.

Note

Oavsett trådsäkerhet kan oväntad delning av CookieContainer instanser leda till problem när du arbetar med HttpClient och HttpClientHandler eller SocketsHttpHandler, eftersom delar av programmet som inte är avsedda att dela cookies med varandra oavsiktligt kan göra det. Vi rekommenderar inte att du använder cookies tillsammans med IHttpClientFactory.

Konstruktorer

Name Description
CookieContainer()

Initierar en ny instans av CookieContainer klassen.
CookieContainer(Int32, Int32, Int32)

Initierar en ny instans av CookieContainer klassen med specifika egenskaper.
CookieContainer(Int32)

Initierar en ny instans av CookieContainer klassen med ett angivet värde för antalet Cookie instanser som containern kan innehålla.

Fält

Name Description
DefaultCookieLengthLimit

Representerar den maximala standardstorleken, i byte, för de Cookie instanser som CookieContainer kan hållas. Det här fältet är konstant.
DefaultCookieLimit

Representerar det maximala standardantalet Cookie instanser som CookieContainer kan lagras. Det här fältet är konstant.
DefaultPerDomainCookieLimit

Representerar det maximala standardantalet Cookie instanser som CookieContainer kan referera till per domän. Det här fältet är konstant.

Egenskaper

Name Description
Capacity

Hämtar eller anger antalet Cookie instanser som en CookieContainer kan innehålla.
Count

Hämtar antalet Cookie instanser som för CookieContainer närvarande finns.
MaxCookieSize

Representerar den maximala tillåtna längden för en Cookie.
PerDomainCapacity

Hämtar eller anger antalet Cookie instanser som en CookieContainer kan lagra per domän.

Metoder

Name Description
Add(Cookie)

Lägger till en Cookie i en CookieContainer. Den här metoden använder domänen från Cookie för att avgöra vilken domänsamling som ska associeras Cookie med.
Add(CookieCollection)

Lägger till innehållet i en CookieCollection i CookieContainer.
Add(Uri, Cookie)

Lägger till en Cookie till CookieContainer för en viss URI.
Add(Uri, CookieCollection)

Lägger till innehållet i en CookieCollection i CookieContainer för en viss URI.
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
GetCookieHeader(Uri)

Hämtar HTTP-cookiehuvudet som innehåller HTTP-cookies som representerar de Cookie instanser som är associerade med en specifik URI.
GetCookies(Uri)

Hämtar en CookieCollection som innehåller de Cookie instanser som är associerade med en specifik URI.
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
SetCookies(Uri, String)

Lägger till Cookie instanser för en eller flera cookies från en HTTP-cookierubrik till CookieContainer för en specifik URI.
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)

Gäller för

Se även