CookieContainer CookieContainer CookieContainer CookieContainer Class

Definición

Proporciona un contenedor para una colección de objetos CookieCollection.Provides a container for a collection of CookieCollection objects.

public ref class CookieContainer
[System.Serializable]
public class CookieContainer
type CookieContainer = class
Public Class CookieContainer
Herencia
CookieContainerCookieContainerCookieContainerCookieContainer
Atributos

Comentarios

Un CookieContainer es una estructura de datos que proporciona almacenamiento para las instancias de la Cookie clase, y que se accede de forma similar a base de datos.A CookieContainer is a data structure that provides storage for instances of the Cookie class, and which is accessed in a database-like manner. El CookieContainer tiene un límite de capacidad que se establece cuando el contenedor se crea o modifica mediante una propiedad.The CookieContainer has a capacity limit that is set when the container is created or changed by a property.

Una instancia de la Cookie clase se agrega al contenedor según su URI.An instance of the Cookie class is added to the container based on its originating URI. Se agrega a una instancia interna CookieCollection asociada al identificador URI.It is added to an internal CookieCollection associated with the URI. Un Cookie se recuperan desde el contenedor basándose en el URI como una CookieCollection, o como una cadena que se puede usar para enviar HTTP WebRequests.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.

El CookieContainer tiene tres propiedades que controlan el volumen del contenido del contenedor: Capacity, MaxCookieSize, y PerDomainCapacity.The CookieContainer has three properties that govern the volume of the content of the container: Capacity, MaxCookieSize, and PerDomainCapacity. Estos valores tienen la configuración predeterminada de 300, 4096 y 20, respectivamente.These values have the default settings of 300, 4096, and 20 respectively. Cuando un Cookie se agrega al contenedor, estas propiedades se utilizan para determinar si un Cookie ya incluido en el CookieContainer debe descartarse para dejar espacio para uno nuevo.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. El CookieContainer realiza un seguimiento de cada suma para asegurarse de que no la Capacity ni el PerDomainCapacity se superen los límites.The CookieContainer keeps track of each addition to ensure that neither the Capacity nor the PerDomainCapacity limits are exceeded. Si uno o ambos se superan, a continuación, Cookie instancias mantienen por el CookieContainer se quitan.If one or both are exceeded, then Cookie instances held by the CookieContainer are removed. En primer lugar, cualquier expiradas Cookie se quita.First, any expired Cookie is removed. Si debe recuperarse más capacidad, entonces usado menos recientemente CookieCollection se purgan.If further capacity must be recaptured, then the least-recently used CookieCollection is purged.

Constructores

CookieContainer() CookieContainer() CookieContainer() CookieContainer()

Inicializa una nueva instancia de la clase CookieContainer.Initializes a new instance of the CookieContainer class.

CookieContainer(Int32) CookieContainer(Int32) CookieContainer(Int32) CookieContainer(Int32)

Inicializa una nueva instancia de la clase CookieContainer con un valor especificado para el número de instancias de Cookie que puede contener el contenedor.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(Int32, Int32, Int32) CookieContainer(Int32, Int32, Int32) CookieContainer(Int32, Int32, Int32)

Inicializa una nueva instancia de la clase CookieContainer con propiedades específicas.Initializes a new instance of the CookieContainer class with specific properties.

Campos

DefaultCookieLengthLimit DefaultCookieLengthLimit DefaultCookieLengthLimit DefaultCookieLengthLimit

Representa el tamaño máximo predeterminado, en bytes, de las instancias de Cookie que puede contener CookieContainer.Represents the default maximum size, in bytes, of the Cookie instances that the CookieContainer can hold. Este campo es constante.This field is constant.

DefaultCookieLimit DefaultCookieLimit DefaultCookieLimit DefaultCookieLimit

Representa el número máximo predeterminado de instancias de Cookie que puede contener CookieContainer.Represents the default maximum number of Cookie instances that the CookieContainer can hold. Este campo es constante.This field is constant.

DefaultPerDomainCookieLimit DefaultPerDomainCookieLimit DefaultPerDomainCookieLimit DefaultPerDomainCookieLimit

Representa el número máximo predeterminado de instancias de Cookie a las que CookieContainer puede hacer referencia por dominio.Represents the default maximum number of Cookie instances that the CookieContainer can reference per domain. Este campo es constante.This field is constant.

Propiedades

Capacity Capacity Capacity Capacity

Obtiene o establece el número de instancias de Cookie que puede contener un CookieContainer.Gets or sets the number of Cookie instances that a CookieContainer can hold.

Count Count Count Count

Obtiene el número de instancias de Cookie que contiene actualmente un objeto CookieContainer.Gets the number of Cookie instances that a CookieContainer currently holds.

MaxCookieSize MaxCookieSize MaxCookieSize MaxCookieSize

Representa la longitud máxima permitida de un objeto Cookie.Represents the maximum allowed length of a Cookie.

PerDomainCapacity PerDomainCapacity PerDomainCapacity PerDomainCapacity

Obtiene o establece el número de instancias de Cookie que puede contener un CookieContainer por dominio.Gets or sets the number of Cookie instances that a CookieContainer can hold per domain.

Métodos

Add(Cookie) Add(Cookie) Add(Cookie) Add(Cookie)

Agrega un objeto Cookie a un CookieContainer.Adds a Cookie to a CookieContainer. Este método utiliza el dominio del objeto Cookie para determinar con qué colección de dominio debe asociarse el objeto Cookie.This method uses the domain from the Cookie to determine which domain collection to associate the Cookie with.

Add(CookieCollection) Add(CookieCollection) Add(CookieCollection) Add(CookieCollection)

Agrega el contenido de un objeto CookieCollection al objeto CookieContainer.Adds the contents of a CookieCollection to the CookieContainer.

Add(Uri, Cookie) Add(Uri, Cookie) Add(Uri, Cookie) Add(Uri, Cookie)

Agrega un objeto Cookie al objeto CookieContainer para un URI en particular.Adds a Cookie to the CookieContainer for a particular URI.

Add(Uri, CookieCollection) Add(Uri, CookieCollection) Add(Uri, CookieCollection) Add(Uri, CookieCollection)

Agrega el contenido de un objeto CookieCollection al objeto CookieContainer para un URI en particular.Adds the contents of a CookieCollection to the CookieContainer for a particular URI.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetCookieHeader(Uri) GetCookieHeader(Uri) GetCookieHeader(Uri) GetCookieHeader(Uri)

Obtiene el encabezado de cookie HTTP que contiene las cookies HTTP que representan las instancias de Cookie asociadas con un URI específico.Gets the HTTP cookie header that contains the HTTP cookies that represent the Cookie instances that are associated with a specific URI.

GetCookies(Uri) GetCookies(Uri) GetCookies(Uri) GetCookies(Uri)

Obtiene un objeto CookieCollection que contiene las instancias de Cookie asociadas con un URI específico.Gets a CookieCollection that contains the Cookie instances that are associated with a specific URI.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
SetCookies(Uri, String) SetCookies(Uri, String) SetCookies(Uri, String) SetCookies(Uri, String)

Agrega instancias de Cookie para una o más cookies de un encabezado cookie HTTP al objeto CookieContainer correspondiente a un URI específico.Adds Cookie instances for one or more cookies from an HTTP cookie header to the CookieContainer for a specific URI.

ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Se aplica a

Consulte también: