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
- Атрибуты
Комментарии
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, Int32, Int32) |
Инициализирует новый экземпляр класса CookieContainer с определенными свойствами. |
CookieContainer(Int32) |
Инициализирует новый экземпляр класса CookieContainer с указанным значением для количества экземпляров Cookie, которые контейнер может хранить. |
Поля
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, содержащий HTTP-файлы cookie, представляющие экземпляры 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) |