CookieContainer Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет контейнер для коллекции CookieCollection объектов.
public ref class CookieContainerpublic ref class CookieContainer sealedpublic class CookieContainer[System.Serializable]
public class CookieContainerpublic sealed class CookieContainertype CookieContainer = class[<System.Serializable>]
type CookieContainer = classPublic Class CookieContainerPublic 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 ресурс очищается.
Потокобезопасность
Методы для добавления и извлечения Cookie экземпляров CookieContainer в потокобезопасны и могут использоваться одновременно из нескольких потоков.
Note
Независимо от безопасности потока, непреднамеренный общий доступ CookieContainer к экземплярам может привести к проблемам при работе с HttpClient и HttpClientHandler или SocketsHttpHandler, так как части приложения, которые не предназначены для совместного использования файлов cookie друг с другом, могут непреднамеренно сделать это. Не рекомендуется использовать файлы cookie вместе с IHttpClientFactory.
Конструкторы
| Имя | Описание |
|---|---|
| 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) |
Добавляет к объекту CookieCookieContainer. Этот метод использует домен из Cookie коллекции для определения коллекции доменов для связывания Cookie с ним. |
| Add(CookieCollection) |
Добавляет содержимое CookieCollection объекта CookieContainerв объект . |
| Add(Uri, Cookie) |
Добавляет в CookieCookieContainer определенный универсальный код ресурса (URI). |
| Add(Uri, CookieCollection) |
Добавляет содержимое объекта в CookieCollectionCookieContainer определенный универсальный код ресурса (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 из заголовка CookieContainer HTTP-файла cookie в конкретный универсальный код ресурса (URI). |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
