CookieContainer Clase

Definición

Proporciona un contenedor para una colección de CookieCollection objetos .

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
Herencia
CookieContainer
Atributos

Comentarios

Es CookieContainer una estructura de datos que proporciona almacenamiento para instancias de la clase y a la Cookie que se accede de forma similar a una base de datos. CookieContainer tiene un límite de capacidad que se establece cuando una propiedad crea o cambia el contenedor.

Se agrega una instancia de la Cookie clase al contenedor en función de su URI de origen. Se agrega a un elemento interno CookieCollection asociado al URI. Cookie Se recupera del contenedor basándose en el URI como , CookieCollectiono como una cadena que se puede usar para enviar HTTP WebRequests.

CookieContainer Tiene tres propiedades que rigen el volumen del contenido del contenedor: Capacity, MaxCookieSizey PerDomainCapacity. Estos valores tienen la configuración predeterminada de 300, 4096 y 20 respectivamente. Cuando se agrega un Cookie elemento al contenedor, estas propiedades se usan para determinar si se debe descartar un Cookie elemento ya incluido en CookieContainer para dejar espacio para el nuevo. Realiza CookieContainer un seguimiento de cada adición para asegurarse de que no se superen ni los CapacityPerDomainCapacity límites. Si se supera uno o ambos, Cookie se quitan las instancias que mantiene .CookieContainer En primer lugar, se quita cualquier expirado Cookie . Si se debe volver a capturar más capacidad, se purga el uso CookieCollection menos reciente.

Seguridad de hilos

Los métodos para agregar y recuperar Cookie instancias a y CookieContainer desde son seguros para subprocesos y se pueden usar simultáneamente desde varios subprocesos.

Note

Independientemente de la seguridad de los subprocesos, el uso compartido imprevisto de CookieContainer instancias puede provocar problemas al trabajar con HttpClient y o HttpClientHandlerSocketsHttpHandler, ya que las partes de la aplicación que no están pensadas para compartir cookies entre sí podrían hacerlo involuntariamente. No se recomienda usar cookies junto con IHttpClientFactory.

Constructores

Nombre Description
CookieContainer()

Inicializa una nueva instancia de la clase CookieContainer.

CookieContainer(Int32, Int32, Int32)

Inicializa una nueva instancia de la CookieContainer clase con propiedades específicas.

CookieContainer(Int32)

Inicializa una nueva instancia de la CookieContainer clase con un valor especificado para el número de Cookie instancias que el contenedor puede contener.

Campos

Nombre Description
DefaultCookieLengthLimit

Representa el tamaño máximo predeterminado, en bytes, de las Cookie instancias que CookieContainer puede contener. Este campo es constante.

DefaultCookieLimit

Representa el número máximo predeterminado de Cookie instancias que CookieContainer puede contener. Este campo es constante.

DefaultPerDomainCookieLimit

Representa el número máximo predeterminado de Cookie instancias a las CookieContainer que puede hacer referencia por dominio. Este campo es constante.

Propiedades

Nombre Description
Capacity

Obtiene o establece el número de Cookie instancias que puede contener .CookieContainer

Count

Obtiene el número de Cookie instancias que un CookieContainer objeto contiene actualmente.

MaxCookieSize

Representa la longitud máxima permitida de .Cookie

PerDomainCapacity

Obtiene o establece el número de Cookie instancias que un CookieContainer objeto puede contener por dominio.

Métodos

Nombre Description
Add(Cookie)

Agrega un Cookie objeto a un CookieContainerobjeto . Este método usa el dominio de Cookie para determinar a qué colección de dominios se va a asociar.Cookie

Add(CookieCollection)

Agrega el contenido de a CookieCollection .CookieContainer

Add(Uri, Cookie)

Agrega un Cookie objeto a CookieContainer para un URI determinado.

Add(Uri, CookieCollection)

Agrega el contenido de a CookieCollection para CookieContainer un URI determinado.

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.

(Heredado de Object)
GetCookieHeader(Uri)

Obtiene el encabezado de cookie HTTP que contiene las cookies HTTP que representan las Cookie instancias asociadas a un URI específico.

GetCookies(Uri)

Obtiene un CookieCollection objeto que contiene las Cookie instancias asociadas a un URI específico.

GetHashCode()

Actúa como la función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Objectactual.

(Heredado de Object)
SetCookies(Uri, String)

Agrega Cookie instancias de una o varias cookies de un encabezado de cookie HTTP al CookieContainer para un URI específico.

ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Se aplica a

Consulte también