CookieContainer.Add Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestawy:

netstandard.dll, System.Net.Primitives.dll

Dodaje element Cookie do elementu CookieContainer.

Przeciążenia

Nazwa	Opis
Add(Cookie)	Dodaje element Cookie do elementu CookieContainer. Ta metoda używa domeny z klasy , Cookie aby określić, z którą kolekcją domen skojarzyć Cookie element .
Add(CookieCollection)	Dodaje zawartość obiektu CookieCollection do obiektu CookieContainer.
Add(Uri, Cookie)	Dodaje element Cookie do CookieContainer elementu dla określonego identyfikatora URI.
Add(Uri, CookieCollection)	Dodaje zawartość elementu CookieCollection do CookieContainer elementu dla określonego identyfikatora URI.

Add(Cookie)

Źródło:

CookieContainer.cs

Dodaje element Cookie do elementu CookieContainer. Ta metoda używa domeny z klasy , Cookie aby określić, z którą kolekcją domen skojarzyć Cookie element .

public:
 void Add(System::Net::Cookie ^ cookie);

public void Add(System.Net.Cookie cookie);

member this.Add : System.Net.Cookie -> unit

Public Sub Add (cookie As Cookie)

Parametry

cookie

Cookie

Element Cookie do dodania do elementu CookieContainer.

Wyjątki

ArgumentNullException

Parametr cookie ma wartość null.

ArgumentException

Domena dla cookie parametru to null lub pusty ciąg ("").

CookieException

cookie jest większy niż maxCookieSize.

— lub —

domena dla cookie elementu nie jest prawidłowym identyfikatorem URI.

Uwagi

Count Jeśli właściwość jest równa lub przekracza Capacity właściwość, co najmniej jedno Cookie wystąpienie zostanie usunięte z kontenera przed dodaniem parametrucookie. Usunięcie wystarczającej liczby Cookie wystąpień w następujący CapacityCount sposób: jeśli w danym zakresie istnieją wygasłe wystąpienia, zostaną wyczyszczone. Jeśli nie, zostanie znaleziony i usunięty z kontenera najmniej ostatnio używany CookieCollection .

Zobacz też

• Cookie
• CookieCollection
• CookieContainer
• CookieException

Add(CookieCollection)

Źródło:

CookieContainer.cs

Dodaje zawartość obiektu CookieCollection do obiektu CookieContainer.

public:
 void Add(System::Net::CookieCollection ^ cookies);

public void Add(System.Net.CookieCollection cookies);

member this.Add : System.Net.CookieCollection -> unit

Public Sub Add (cookies As CookieCollection)

Parametry

cookies

CookieCollection

Element CookieCollection do dodania do elementu CookieContainer.

Wyjątki

ArgumentNullException

Parametr cookies ma wartość null.

Uwagi

Count Jeśli właściwość jest równa Capacity właściwości, co najmniej jedno Cookie wystąpienie zostanie usunięte z kontenera przed dodaniem zawartości parametrucookies. Usunięcie wystarczającej liczby Cookie wystąpień w następujący cookies sposób: jeśli wystąpią wygasłe wystąpienia, zostaną wyczyszczone. Jeśli nie, lub jeśli potrzebujesz więcej miejsca, zostanie znaleziona i usunięta z kontenera najmniej ostatnio używane CookieCollection .

Zobacz też

• Cookie
• CookieCollection
• CookieContainer
• CookieException

Add(Uri, Cookie)

Źródło:

CookieContainer.cs

Dodaje element Cookie do CookieContainer elementu dla określonego identyfikatora URI.

public:
 void Add(Uri ^ uri, System::Net::Cookie ^ cookie);

public void Add(Uri uri, System.Net.Cookie cookie);

member this.Add : Uri * System.Net.Cookie -> unit

Public Sub Add (uri As Uri, cookie As Cookie)

Parametry

uri

Uri

Identyfikator URI elementu Cookie , który ma zostać dodany do elementu CookieContainer.

cookie

Cookie

Element Cookie do dodania do elementu CookieContainer.

Wyjątki

ArgumentNullException

uri jest lub nullcookie ma wartość null.

CookieException

cookie jest większy niż maxCookieSize.

— lub —

Domena dla cookie elementu nie jest prawidłowym identyfikatorem URI.

Uwagi

W przypadku dodania Cookie wystąpienia tylko jednego określonego Cookie hosta nie należy ustawiać Domain właściwości wystąpienia. Jest on ustawiany automatycznie na podstawie identyfikatora URI.

Jeśli identyfikator URI odpowiada domenie lokalnej i wysyła do wszystkich hostów w domenie lokalnej, ustaw właściwość równą Cookie.Domain ".local". W przeciwnym razie upewnij się, że jest zgodna z nazwą hosta używaną w identyfikatorze URI.

Version Jeśli właściwość obiektu Cookie to Netscape, Path właściwość Cookie, jeśli nie jest ustawiona jawnie, pochodzi z identyfikatora URI i jest pełną ścieżką z identyfikatora URI, w tym z nazwą strony.

Count Jeśli właściwość jest równa Capacity właściwości, co najmniej jedno Cookie wystąpienie zostanie usunięte z kontenera przed dodaniem parametrucookie. Usunięcie wystarczającej liczby Cookie wystąpień w następujący CapacityCount sposób: jeśli istnieją wygasłe wystąpienia w zakresie, zostaną one wyczyszczone. Jeśli nie, zostanie znaleziony i usunięty z kontenera najmniej ostatnio używany CookieCollection .

Zobacz też

• Cookie
• CookieCollection
• CookieContainer
• CookieException

Add(Uri, CookieCollection)

Źródło:

CookieContainer.cs

Dodaje zawartość elementu CookieCollection do CookieContainer elementu dla określonego identyfikatora URI.

public:
 void Add(Uri ^ uri, System::Net::CookieCollection ^ cookies);

public void Add(Uri uri, System.Net.CookieCollection cookies);

member this.Add : Uri * System.Net.CookieCollection -> unit

Public Sub Add (uri As Uri, cookies As CookieCollection)

Parametry

uri

Uri

Identyfikator URI elementu CookieCollection , który ma zostać dodany do elementu CookieContainer.

cookies

CookieCollection

Element CookieCollection do dodania do elementu CookieContainer.

Wyjątki

ArgumentNullException

Parametr cookies ma wartość null.

ArgumentException

Domena jednego z plików cookie w pliku cookies to null.

CookieException

Jeden z plików cookie w pliku cookies zawiera nieprawidłową domenę.

Uwagi

W przypadku dodania Cookie wystąpienia tylko jednego określonego Cookie hosta nie należy ustawiać Domain właściwości wystąpienia. Jest on ustawiany automatycznie na podstawie identyfikatora URI.

Jeśli identyfikator URI odpowiada domenie lokalnej i wysyła do wszystkich hostów w domenie lokalnej, ustaw właściwość równą CookieDomain ".local". W przeciwnym razie upewnij się, że jest zgodna z nazwą hosta używaną w identyfikatorze URI.

Jeśli Count równa Capacitysię , co najmniej jedno Cookie wystąpienie zostanie usunięte z kontenera przed dodaniem parametru cookie . Usunięcie wystarczającej liczby Cookie wystąpień w następujący sposób CountCapacity : jeśli istnieją wygasłe wystąpienia w zakresie, zostaną wyczyszczone. Jeśli nie, zostanie znaleziony i usunięty z kontenera najmniej ostatnio używany CookieCollection .

Zobacz też

• Cookie
• CookieCollection
• CookieContainer
• CookieException