Поделиться через


CookieContainer.Add Метод

Определение

Добавляет объект 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
Исходный код:
CookieContainer.cs
Исходный код:
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.

Исключения

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

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

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

-или-

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

Комментарии

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

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

Применяется к

Add(CookieCollection)

Исходный код:
CookieContainer.cs
Исходный код:
CookieContainer.cs
Исходный код:
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.

Исключения

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

Комментарии

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

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

Применяется к

Add(Uri, Cookie)

Исходный код:
CookieContainer.cs
Исходный код:
CookieContainer.cs
Исходный код:
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.

Исключения

Значение параметра urinull, или значение параметра cookienull.

Значение 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 недавно.

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

Применяется к

Add(Uri, CookieCollection)

Исходный код:
CookieContainer.cs
Исходный код:
CookieContainer.cs
Исходный код:
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.

Исключения

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

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

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

Комментарии

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

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

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

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

Применяется к