CookieContainer.Add Метод

Определение

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

System.Net

Сборка:

System.Net.Primitives.dll

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

Перегрузки

Add(Cookie)	Добавляет объект Cookie в CookieContainer. В этом методе используется домен из класса Cookie для определения доменной коллекции, которую требуется связать с Cookie.
Add(CookieCollection)	Добавляет содержимое CookieCollection в CookieContainer.
Add(Uri, Cookie)	Добавляет экземпляр Cookie в CookieContainer для определенного URI.
Add(Uri, CookieCollection)	Добавляет содержимое CookieCollection в CookieContainer для определенного URI.

Add(Cookie)

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

CookieContainer.cs

Добавляет объект Cookie в CookieContainer. В этом методе используется домен из класса 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

Домен для cookie является null или пустой строкой ("").

CookieException

Значение cookie больше, чем значение maxCookieSize

-или-

домен для cookie не является допустимым URI.

Комментарии

Если свойство равно свойству CountCapacity или превышает его, один или несколько 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

Добавляет экземпляр Cookie в CookieContainer для определенного 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 объекта Cookie, добавляемого в CookieContainer.

cookie

Cookie

Действие Cookie, добавляемое в коллекцию CookieContainer.

Исключения

ArgumentNullException

Значение параметра uri — null, или значение параметра cookie — null.

CookieException

Значение cookie больше, чем значение maxCookieSize

-или-

Домен для cookie не является допустимым URI.

Комментарии

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

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

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

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

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

• Cookie
• CookieCollection
• CookieContainer
• CookieException

Add(Uri, CookieCollection)

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

CookieContainer.cs

Добавляет содержимое CookieCollection в CookieContainer для определенного 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 объекта CookieCollection, добавляемого в CookieContainer.

cookies

CookieCollection

Действие CookieCollection, добавляемое в коллекцию CookieContainer.

Исключения

ArgumentNullException

cookies имеет значение null.

ArgumentException

Домен для одного из файлов cookie в cookies указан как null.

CookieException

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

Комментарии

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

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

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

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

• Cookie
• CookieCollection
• CookieContainer
• CookieException