CookieContainer Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет контейнер для коллекции объектов CookieCollection.
public ref class CookieContainer
public ref class CookieContainer sealed
public class CookieContainer
[System.Serializable]
public class CookieContainer
public sealed class CookieContainer
type CookieContainer = class
[<System.Serializable>]
type CookieContainer = class
Public Class CookieContainer
Public NotInheritable Class CookieContainer
- Наследование
-
CookieContainer
- Атрибуты
Комментарии
A CookieContainer — это структура данных, предоставляющая хранилище для экземпляров Cookie класса и доступ к которой осуществляется аналогично базе данных. Ограничение CookieContainer емкости устанавливается при создании или изменении контейнера свойством.
Экземпляр Cookie класса добавляется в контейнер на основе исходного URI. Он добавляется во внутренний CookieCollection связанный с URI. Извлекается Cookie из контейнера на основе универсального кода ресурса (URI) или в виде CookieCollectionстроки, которую можно использовать для отправки HTTP WebRequests.
Имеет CookieContainer три свойства, которые управляют объемом содержимого контейнера: Capacity, MaxCookieSizeи PerDomainCapacity. Эти значения имеют значения по умолчанию 300, 4096 и 20 соответственно. Cookie При добавлении объекта в контейнер эти свойства используются для определения того, следует ли Cookie удалить уже содержащийся в контейнереCookieContainer, чтобы освободить место для нового. Отслеживайте CookieContainer каждое добавление, чтобы убедиться, что ни Capacity PerDomainCapacity ограничения не будут превышены. При превышении Cookie одного или обоих экземпляров CookieContainer удаляются. Во-первых, все истекшие Cookie сроки действия удаляются. Если необходимо восстановить дополнительную емкость, то наименее недавно используемая емкость CookieCollection очищается.
Конструкторы
CookieContainer() |
Инициализирует новый экземпляр класса CookieContainer. |
CookieContainer(Int32) |
Инициализирует новый экземпляр класса CookieContainer с указанным значением для количества экземпляров Cookie, которое может храниться в контейнере. |
CookieContainer(Int32, Int32, Int32) |
Инициализирует новый экземпляр класса CookieContainer с определенными свойствами. |
Поля
DefaultCookieLengthLimit |
Представляет используемый по умолчанию максимальный размер в байтах экземпляров Cookie, которые могут храниться в CookieContainer. Это поле является константой. |
DefaultCookieLimit |
Представляет используемое по умолчанию максимальное число экземпляров Cookie, которые могут храниться в CookieContainer. Это поле является константой. |
DefaultPerDomainCookieLimit |
Представляет используемое по умолчанию максимальное число экземпляров Cookie, которые могут храниться в CookieContainer для каждого домена. Это поле является константой. |
Свойства
Capacity |
Получает или задает количество экземпляров Cookie, которое может храниться в CookieContainer. |
Count |
Возвращает количество экземпляров Cookie, хранящихся в текущий момент в CookieContainer. |
MaxCookieSize |
Представляет максимально допустимую длину Cookie. |
PerDomainCapacity |
Получает или задает количество экземпляров Cookie, которое может храниться в CookieContainer для каждого домена. |
Методы
Add(Cookie) |
Добавляет объект Cookie в CookieContainer. В этом методе используется домен из класса Cookie для определения доменной коллекции, которую требуется связать с Cookie. |
Add(CookieCollection) |
Добавляет содержимое CookieCollection в CookieContainer. |
Add(Uri, Cookie) |
Добавляет экземпляр Cookie в CookieContainer для определенного URI. |
Add(Uri, CookieCollection) |
Добавляет содержимое CookieCollection в CookieContainer для определенного URI. |
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
GetAllCookies() |
Возвращает объект CookieCollection , содержащий все Cookie экземпляры в контейнере. |
GetCookieHeader(Uri) |
Возвращает заголовок HTTP-cookie, содержащий файлы cookie HTTP, которые представляют экземпляры Cookie, связанные с определенным URI. |
GetCookies(Uri) |
Возвращает коллекцию CookieCollection, содержащую экземпляры Cookie, связанные с указанным URI. |
GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
SetCookies(Uri, String) |
Добавляет экземпляры Cookie для одного или нескольких файлов cookie из заголовка HTTP-cookie в класс CookieContainer для определенного URI. |
ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |