CookieContainer Classe

Definição

Fornece um contêiner para uma coleção de objetos 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
Herança
CookieContainer
Atributos

Comentários

Um CookieContainer é uma estrutura de dados que fornece armazenamento para instâncias da Cookie classe e que é acessada de maneira semelhante a um banco de dado.A CookieContainer is a data structure that provides storage for instances of the Cookie class, and which is accessed in a database-like manner. O CookieContainer tem um limite de capacidade definido quando o contêiner é criado ou alterado por uma propriedade.The CookieContainer has a capacity limit that is set when the container is created or changed by a property.

Uma instância da Cookie classe é adicionada ao contêiner com base em seu URI de origem.An instance of the Cookie class is added to the container based on its originating URI. Ele é adicionado a um interno CookieCollection associado ao URI.It is added to an internal CookieCollection associated with the URI. Um Cookie é recuperado do contêiner com base no URI como um CookieCollection , ou como uma cadeia de caracteres que pode ser usada para enviar requests 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.

O CookieContainer tem três propriedades que regem o volume do conteúdo do contêiner: Capacity , MaxCookieSize e PerDomainCapacity .The CookieContainer has three properties that govern the volume of the content of the container: Capacity, MaxCookieSize, and PerDomainCapacity. Esses valores têm as configurações padrão de 300, 4096 e 20, respectivamente.These values have the default settings of 300, 4096, and 20 respectively. Quando um Cookie é adicionado ao contêiner, essas propriedades são usadas para determinar se um Cookie já contido no CookieContainer deve ser Descartado para liberar espaço para o novo.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. O CookieContainer mantém o controle de cada adição para garantir que nem os Capacity PerDomainCapacity limites não sejam excedidos.The CookieContainer keeps track of each addition to ensure that neither the Capacity nor the PerDomainCapacity limits are exceeded. Se um ou ambos forem excedidos, as Cookie instâncias mantidas pelo CookieContainer serão removidas.If one or both are exceeded, then Cookie instances held by the CookieContainer are removed. Primeiro, todos os expirados Cookie são removidos.First, any expired Cookie is removed. Se a capacidade adicional precisar ser recapturada, o usado pelo menos recentemente CookieCollection será limpo.If further capacity must be recaptured, then the least-recently used CookieCollection is purged.

Construtores

CookieContainer()

Inicializa uma nova instância da classe CookieContainer.Initializes a new instance of the CookieContainer class.

CookieContainer(Int32)

Inicializa uma nova instância da classe CookieContainer com um valor especificado para o número de instâncias Cookie que o contêiner pode conter.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)

Inicializa uma nova instância da classe CookieContainer com propriedades específicas.Initializes a new instance of the CookieContainer class with specific properties.

Campos

DefaultCookieLengthLimit

Representa o tamanho máximo padrão, em bytes, das instâncias Cookie que o CookieContainer pode conter.Represents the default maximum size, in bytes, of the Cookie instances that the CookieContainer can hold. Este campo é constante.This field is constant.

DefaultCookieLimit

Representa o número máximo padrão de instâncias Cookie que o CookieContainer pode conter.Represents the default maximum number of Cookie instances that the CookieContainer can hold. Este campo é constante.This field is constant.

DefaultPerDomainCookieLimit

Representa o número máximo padrão de instâncias Cookie que o CookieContainer pode referenciar por domínio.Represents the default maximum number of Cookie instances that the CookieContainer can reference per domain. Este campo é constante.This field is constant.

Propriedades

Capacity

Obtém ou define o número de instâncias de Cookie que um CookieContainer pode conter.Gets or sets the number of Cookie instances that a CookieContainer can hold.

Count

Obtém o número de instâncias Cookie que um CookieContainer contém no momento.Gets the number of Cookie instances that a CookieContainer currently holds.

MaxCookieSize

Representa o comprimento máximo permitido de um Cookie.Represents the maximum allowed length of a Cookie.

PerDomainCapacity

Obtém ou define o número de instâncias Cookie que um CookieContainer pode conter por domínio.Gets or sets the number of Cookie instances that a CookieContainer can hold per domain.

Métodos

Add(Cookie)

Adiciona um Cookie a um CookieContainer.Adds a Cookie to a CookieContainer. Esse método usa o domínio do Cookie para determinar à qual coleção de domínio o Cookie deve ser associado.This method uses the domain from the Cookie to determine which domain collection to associate the Cookie with.

Add(CookieCollection)

Adiciona o conteúdo de um CookieCollection ao CookieContainer.Adds the contents of a CookieCollection to the CookieContainer.

Add(Uri, Cookie)

Adiciona um Cookie ao CookieContainer para um URI específico.Adds a Cookie to the CookieContainer for a particular URI.

Add(Uri, CookieCollection)

Adiciona o conteúdo de um CookieCollection ao CookieContainer para um URI específico.Adds the contents of a CookieCollection to the CookieContainer for a particular URI.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetCookieHeader(Uri)

Obtém o cabeçalho de cookie HTTP que contém os cookies HTTP que representam as instâncias Cookie que estão associadas a um 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)

Obtém um CookieCollection que contém as instâncias do Cookie associadas a um URI específico.Gets a CookieCollection that contains the Cookie instances that are associated with a specific URI.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
SetCookies(Uri, String)

Adiciona instâncias de Cookie para um ou mais cookies de um cabeçalho de cookie HTTP para o CookieContainer para um URI específico.Adds Cookie instances for one or more cookies from an HTTP cookie header to the CookieContainer for a specific URI.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Aplica-se a

Veja também