CookieContainer.Add Метод

Определение

Пространство имен:

System.Net

Сборки:

netstandard.dll, System.Net.Primitives.dll

Добавляет к объекту CookieCookieContainer.

Перегрузки

Имя	Описание
Add(Cookie)	Добавляет к объекту CookieCookieContainer. Этот метод использует домен из Cookie коллекции для определения коллекции доменов для связывания Cookie с ним.
Add(CookieCollection)	Добавляет содержимое CookieCollection объекта CookieContainerв объект .
Add(Uri, Cookie)	Добавляет в CookieCookieContainer определенный универсальный код ресурса (URI).
Add(Uri, CookieCollection)	Добавляет содержимое объекта в CookieCollectionCookieContainer определенный универсальный код ресурса (URI).

Add(Cookie)

Исходный код:

CookieContainer.cs

Добавляет к объекту CookieCookieContainer. Этот метод использует домен из Cookie коллекции для определения коллекции доменов для связывания 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)

Параметры

cookie

Cookie

Добавляемый Cookie в объект CookieContainer.

Исключения

ArgumentNullException

cookie равно null.

ArgumentException

Домен или cookienull пустая строка ("").

CookieException

cookie больше maxCookieSize.

–или–

домен cookie для не является допустимым универсальным кодом ресурса (URI).

Комментарии

Count Если свойство равно или превышает Capacity свойство, один или несколько Cookie экземпляров удаляются из контейнера перед добавлением cookie параметра. Достаточно Cookie экземпляров удаляются, чтобы выполнить Count приведенные ниже Capacity действия: если в данной области истек срок действия экземпляров, они удаляются. Если нет, то последний используемый CookieCollection объект найден и удален из контейнера.

См. также раздел

• Cookie
• CookieCollection
• CookieContainer
• CookieException

Add(CookieCollection)

Исходный код:

CookieContainer.cs

Добавляет содержимое CookieCollection объекта 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)

Параметры

cookies

CookieCollection

Добавляемый CookieCollection в объект CookieContainer.

Исключения

ArgumentNullException

cookies равно null.

Комментарии

Count Если свойство равно свойствуCapacity, один или несколько Cookie экземпляров удаляются из контейнера перед добавлением содержимого cookies параметра. Достаточно Cookie экземпляров удаляются, чтобы освободить место cookies следующим образом: если истек срок действия экземпляров, они удаляются. Если нет, или если требуется больше места, то последнее использование CookieCollection обнаруживается и удаляется из контейнера.

См. также раздел

• Cookie
• CookieCollection
• CookieContainer
• CookieException

Add(Uri, Cookie)

Исходный код:

CookieContainer.cs

Добавляет в CookieCookieContainer определенный универсальный код ресурса (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)

Параметры

uri

Uri

URI добавляемого CookieCookieContainerобъекта в .

cookie

Cookie

Добавляемый Cookie в объект CookieContainer.

Исключения

ArgumentNullException

uri is null или cookie is null.

CookieException

cookie больше maxCookieSize.

–или–

Домен cookie для не является допустимым универсальным кодом ресурса (URI).

Комментарии

Если вы добавляете Cookie экземпляр только для одного конкретного узла, не устанавливайте Domain свойство экземпляра Cookie . Этот параметр устанавливается автоматически на основе URI.

Если URI соответствует локальному домену и отправляется всем узлам локального домена, задайте Cookie.Domain для свойства значение "local". В противном случае убедитесь, что он соответствует имени узла, используемому в URI.

Version Если свойство Cookie является Netscape, свойство Cookieсвойства ,если не задано явным образом, Path является производным от URI и является полным путем от URI, включая имя страницы.

Count Если свойство равно свойствуCapacity, один или несколько Cookie экземпляров удаляются из контейнера перед добавлением cookie параметра. Достаточно Cookie экземпляров удаляются, чтобы выполнить Count приведенные ниже Capacity действия: если в области истек срок действия, они удаляются. Если нет, то последний используемый CookieCollection объект найден и удален из контейнера.

См. также раздел

• Cookie
• CookieCollection
• CookieContainer
• CookieException

Add(Uri, CookieCollection)

Исходный код:

CookieContainer.cs

Добавляет содержимое объекта в CookieCollectionCookieContainer определенный универсальный код ресурса (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)

Параметры

uri

Uri

URI добавляемого CookieCollectionCookieContainerобъекта в .

cookies

CookieCollection

Добавляемый CookieCollection в объект CookieContainer.

Исключения

ArgumentNullException

cookies равно null.

ArgumentException

Домен для одного из файлов cookie в cookiesnull.

CookieException

Один из файлов cookie, содержащих cookies недопустимый домен.

Комментарии

Если вы добавляете Cookie экземпляр только для одного конкретного узла, не устанавливайте Domain свойство экземпляра Cookie . Этот параметр устанавливается автоматически на основе URI.

Если URI соответствует локальному домену и отправляется всем узлам локального домена, задайте CookieDomain для свойства значение "local". В противном случае убедитесь, что он соответствует имени узла, используемому в URI.

Если Count равно Capacity, один или несколько Cookie экземпляров удаляются из контейнера перед добавлением cookie параметра. Достаточно Cookie экземпляров удаляются, чтобы выполнить Count приведенные ниже Capacity действия: если истек срок действия экземпляров в области их очистки. Если нет, то последний используемый CookieCollection объект найден и удален из контейнера.

См. также раздел

• Cookie
• CookieCollection
• CookieContainer
• CookieException