CookieContainer Класс

Определение

Предоставляет контейнер для коллекции объектов CookieCollection.Provides a container for a collection of CookieCollection objects.

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 класса, к которым осуществляется доступ в режиме базы данных.A CookieContainer is a data structure that provides storage for instances of the Cookie class, and which is accessed in a database-like manner. CookieContainerИмеет ограничение емкости, которое задается при создании или изменении контейнера свойством.The CookieContainer has a capacity limit that is set when the container is created or changed by a property.

Экземпляр Cookie класса добавляется в контейнер на основе его ИСХОДНОГО URI.An instance of the Cookie class is added to the container based on its originating URI. Он добавляется во внутренний объект, CookieCollection связанный с URI.It is added to an internal CookieCollection associated with the URI. CookieИзвлекается из контейнера на основе URI в виде CookieCollection или строки, которую можно использовать для отправки HTTP-запросов.A Cookie is retrieved from the container based on the URI as a CookieCollection, or as a string that can be used to submit HTTP WebRequests.

CookieContainerИмеет три свойства, которые управляют томом содержимого контейнера: Capacity , MaxCookieSize и PerDomainCapacity .The CookieContainer has three properties that govern the volume of the content of the container: Capacity, MaxCookieSize, and PerDomainCapacity. Эти значения имеют параметры по умолчанию 300, 4096 и 20 соответственно.These values have the default settings of 300, 4096, and 20 respectively. При Cookie добавлении к контейнеру эти свойства используются, чтобы определить, Cookie следует ли удалять уже содержащиеся в элементе, CookieContainer чтобы освободить место для нового.When a Cookie is added to the container, these properties are used to determine whether a Cookie already contained in the CookieContainer should be discarded to make room for the new one. CookieContainerОтслеживает каждое Добавление, чтобы убедиться, что Capacity PerDomainCapacity не превышены ограничения.The CookieContainer keeps track of each addition to ensure that neither the Capacity nor the PerDomainCapacity limits are exceeded. При превышении одного или обоих объектов Cookie экземпляры, удерживаемые, CookieContainer удаляются.If one or both are exceeded, then Cookie instances held by the CookieContainer are removed. Во-первых, удаляются все просроченные Cookie .First, any expired Cookie is removed. Если необходимо повторно записать дополнительную емкость, удаляются наиболее часто используемые CookieCollection .If further capacity must be recaptured, then the least-recently used CookieCollection is purged.

Конструкторы

CookieContainer()

Инициализирует новый экземпляр класса CookieContainer.Initializes a new instance of the CookieContainer class.

CookieContainer(Int32)

Инициализирует новый экземпляр класса CookieContainer с указанным значением для количества экземпляров Cookie, которое может храниться в контейнере.Initializes a new instance of the CookieContainer class with a specified value for the number of Cookie instances that the container can hold.

CookieContainer(Int32, Int32, Int32)

Инициализирует новый экземпляр класса CookieContainer с определенными свойствами.Initializes a new instance of the CookieContainer class with specific properties.

Поля

DefaultCookieLengthLimit

Представляет используемый по умолчанию максимальный размер в байтах экземпляров Cookie, которые могут храниться в CookieContainer.Represents the default maximum size, in bytes, of the Cookie instances that the CookieContainer can hold. Это поле является константой.This field is constant.

DefaultCookieLimit

Представляет используемое по умолчанию максимальное число экземпляров Cookie, которые могут храниться в CookieContainer.Represents the default maximum number of Cookie instances that the CookieContainer can hold. Это поле является константой.This field is constant.

DefaultPerDomainCookieLimit

Представляет используемое по умолчанию максимальное число экземпляров Cookie, которые могут храниться в CookieContainer для каждого домена.Represents the default maximum number of Cookie instances that the CookieContainer can reference per domain. Это поле является константой.This field is constant.

Свойства

Capacity

Получает или задает количество экземпляров Cookie, которое может храниться в CookieContainer.Gets or sets the number of Cookie instances that a CookieContainer can hold.

Count

Возвращает количество экземпляров Cookie, хранящихся в текущий момент в CookieContainer.Gets the number of Cookie instances that a CookieContainer currently holds.

MaxCookieSize

Представляет максимально допустимую длину Cookie.Represents the maximum allowed length of a Cookie.

PerDomainCapacity

Получает или задает количество экземпляров Cookie, которое может храниться в CookieContainer для каждого домена.Gets or sets the number of Cookie instances that a CookieContainer can hold per domain.

Методы

Add(Cookie)

Добавляет объект Cookie в CookieContainer.Adds a Cookie to a CookieContainer. В этом методе используется домен из класса Cookie для определения доменной коллекции, которую требуется связать с Cookie.This method uses the domain from the Cookie to determine which domain collection to associate the Cookie with.

Add(CookieCollection)

Добавляет содержимое CookieCollection в CookieContainer.Adds the contents of a CookieCollection to the CookieContainer.

Add(Uri, Cookie)

Добавляет экземпляр Cookie в CookieContainer для определенного URI.Adds a Cookie to the CookieContainer for a particular URI.

Add(Uri, CookieCollection)

Добавляет содержимое CookieCollection в CookieContainer для определенного URI.Adds the contents of a CookieCollection to the CookieContainer for a particular URI.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetCookieHeader(Uri)

Возвращает заголовок HTTP-cookie, содержащий файлы cookie HTTP, которые представляют экземпляры Cookie, связанные с определенным URI.Gets the HTTP cookie header that contains the HTTP cookies that represent the Cookie instances that are associated with a specific URI.

GetCookies(Uri)

Возвращает коллекцию CookieCollection, содержащую экземпляры Cookie, связанные с указанным URI.Gets a CookieCollection that contains the Cookie instances that are associated with a specific URI.

GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
SetCookies(Uri, String)

Добавляет экземпляры Cookie для одного или нескольких файлов cookie из заголовка HTTP-cookie в класс CookieContainer для определенного URI.Adds Cookie instances for one or more cookies from an HTTP cookie header to the CookieContainer for a specific URI.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

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

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