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)

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

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