CookieContainer.Add Metoda

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.Primitives.dll

Dodaje element Cookie do elementu CookieContainer.

Przeciążenia

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 .
Add(CookieCollection)	Dodaje zawartość elementu CookieCollection do elementu CookieContainer.
Add(Uri, Cookie)	Dodaje element do CookieCookieContainer 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 .

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

cookie to null.

ArgumentException

Domena dla cookie elementu 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 Cookie jedno wystąpienie zostanie usunięte z kontenera przed dodaniem parametrucookie. Liczba Cookie wystąpień jest usuwana CountCapacity w następujący sposób: jeśli istnieją wygasłe wystąpienia w danym zakresie, 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ść elementu CookieCollection do elementu 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

cookies to null.

Uwagi

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

Zobacz też

• Cookie
• CookieCollection
• CookieContainer
• CookieException

Add(Uri, Cookie)

Źródło:

CookieContainer.cs

Dodaje element do CookieCookieContainer 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 do dodania do elementu CookieContainer.

cookie

Cookie

Element Cookie do dodania do elementu CookieContainer.

Wyjątki

ArgumentNullException

uri jest lub nullcookie jest 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 hosta nie należy ustawiać Domain właściwości Cookie wystąpienia. Jest ona ustawiana automatycznie na podstawie identyfikatora URI.

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

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

Count Jeśli właściwość jest równa Capacity właściwości, co najmniej Cookie jedno wystąpienie zostanie usunięte z kontenera przed dodaniem parametrucookie. Liczba Cookie wystąpień jest usuwana w CountCapacity następujący sposób: 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

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 do dodania do elementu CookieContainer.

cookies

CookieCollection

Element CookieCollection do dodania do elementu CookieContainer.

Wyjątki

ArgumentNullException

cookies to null.

ArgumentException

Domeną jednego z plików cookie w pliku cookies jest 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 hosta nie należy ustawiać Domain właściwości Cookie wystąpienia. Jest ona ustawiana automatycznie na podstawie identyfikatora URI.

Jeśli identyfikator URI odpowiada domenie lokalnej i wysyła do wszystkich hostów w domenie lokalnej, ustaw CookieDomain właściwość równą ".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 Cookie jedno wystąpienie zostanie usunięte z kontenera przed dodaniem parametru cookie . 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ą wyczyszczone. Jeśli nie, zostanie znaleziony i usunięty z kontenera najmniej ostatnio używany CookieCollection .

Zobacz też

• Cookie
• CookieCollection
• CookieContainer
• CookieException