CookieContainer Classe

Definição

Fornece um contêiner para uma coleção de objetos CookieCollection.

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 ao banco de dados. O CookieContainer tem um limite de capacidade definido quando o contêiner é criado ou alterado por uma propriedade.

Uma instância da Cookie classe é adicionada ao contêiner com base em seu URI de origem. Ele é adicionado a um interno CookieCollection associado ao URI. Um Cookie é recuperado do contêiner com base no URI como um CookieCollectionou como uma cadeia de caracteres que pode ser usada para enviar WebRequests HTTP.

O CookieContainer tem três propriedades que regem o volume do conteúdo do contêiner: Capacity, MaxCookieSizee PerDomainCapacity. Esses valores têm as configurações padrão de 300, 4096 e 20, respectivamente. 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 abrir espaço para o novo. O CookieContainer controla cada adição para garantir que nem os CapacityPerDomainCapacity limites sejam excedidos. Se um ou ambos forem excedidos, Cookie as instâncias mantidas pelo CookieContainer serão removidas. Primeiro, qualquer expirado Cookie é removido. Se a capacidade adicional precisar ser recapturada, o menos usado CookieCollection recentemente será limpo.

Construtores

CookieContainer()

Inicializa uma nova instância da classe CookieContainer.

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.

CookieContainer(Int32, Int32, Int32)

Inicializa uma nova instância da classe CookieContainer com propriedades específicas.

Campos

DefaultCookieLengthLimit

Representa o tamanho máximo padrão, em bytes, das instâncias Cookie que o CookieContainer pode conter. Este campo é constante.

DefaultCookieLimit

Representa o número máximo padrão de instâncias Cookie que o CookieContainer pode conter. Este campo é constante.

DefaultPerDomainCookieLimit

Representa o número máximo padrão de instâncias Cookie que o CookieContainer pode referenciar por domínio. Este campo é constante.

Propriedades

Capacity

Obtém ou define o número de instâncias de Cookie que um CookieContainer pode conter.

Count

Obtém o número de instâncias Cookie que um CookieContainer contém no momento.

MaxCookieSize

Representa o comprimento máximo permitido de um Cookie.

PerDomainCapacity

Obtém ou define o número de instâncias Cookie que um CookieContainer pode conter por domínio.

Métodos

Add(Cookie)

Adiciona um Cookie a um CookieContainer. Esse método usa o domínio do Cookie para determinar à qual coleção de domínio o Cookie deve ser associado.

Add(CookieCollection)

Adiciona o conteúdo de um CookieCollection ao CookieContainer.

Add(Uri, Cookie)

Adiciona um Cookie ao CookieContainer para um URI específico.

Add(Uri, CookieCollection)

Adiciona o conteúdo de um CookieCollection ao CookieContainer para um URI específico.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetAllCookies()

Obtém um CookieCollection que contém todas as Cookie instâncias no contêiner.

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.

GetCookies(Uri)

Obtém um CookieCollection que contém as instâncias do Cookie associadas a um URI específico.

GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(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.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Confira também