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