CookieContainer Classe

Definizione

Fornisce un contenitore per una raccolta di oggetti 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
Ereditarietà
CookieContainer
Attributi

Commenti

Un oggetto CookieContainer è una struttura di dati che fornisce l'archiviazione per le istanze della Cookie classe e a cui si accede in modo analogo al database.A CookieContainer is a data structure that provides storage for instances of the Cookie class, and which is accessed in a database-like manner. CookieContainerHa un limite di capacità impostato quando il contenitore viene creato o modificato da una proprietà.The CookieContainer has a capacity limit that is set when the container is created or changed by a property.

Un'istanza della Cookie classe viene aggiunta al contenitore in base al relativo URI di origine.An instance of the Cookie class is added to the container based on its originating URI. Viene aggiunto a un oggetto interno CookieCollection associato all'URI.It is added to an internal CookieCollection associated with the URI. Un oggetto Cookie viene recuperato dal contenitore in base all'URI come CookieCollection o come stringa che può essere utilizzata per inviare richieste http 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.

CookieContainerDispone di tre proprietà che regolano il volume del contenuto del contenitore: Capacity , MaxCookieSize e PerDomainCapacity .The CookieContainer has three properties that govern the volume of the content of the container: Capacity, MaxCookieSize, and PerDomainCapacity. Questi valori hanno rispettivamente le impostazioni predefinite 300, 4096 e 20.These values have the default settings of 300, 4096, and 20 respectively. Quando un oggetto Cookie viene aggiunto al contenitore, queste proprietà vengono utilizzate per determinare se un oggetto Cookie già contenuto nell'oggetto CookieContainer deve essere ignorato per fare spazio a quello nuovo.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. CookieContainerTiene traccia di ogni aggiunta per assicurarsi che non venga superato né né i Capacity PerDomainCapacity limiti.The CookieContainer keeps track of each addition to ensure that neither the Capacity nor the PerDomainCapacity limits are exceeded. Se viene superato uno o entrambi, Cookie le istanze contenute in CookieContainer vengono rimosse.If one or both are exceeded, then Cookie instances held by the CookieContainer are removed. In primo luogo, eventuali scaduti Cookie vengono rimossi.First, any expired Cookie is removed. Se è necessario riacquisire la capacità aggiuntiva, il meno recente usato CookieCollection viene eliminato.If further capacity must be recaptured, then the least-recently used CookieCollection is purged.

Costruttori

CookieContainer()

Inizializza una nuova istanza della classe CookieContainer.Initializes a new instance of the CookieContainer class.

CookieContainer(Int32)

Inizializza una nuova istanza della classe CookieContainer con un valore specificato per il numero di istanze di Cookie che possono essere mantenute nel contenitore.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)

Inizializza una nuova istanza della classe CookieContainercon specifiche proprietà.Initializes a new instance of the CookieContainer class with specific properties.

Campi

DefaultCookieLengthLimit

Rappresenta la dimensione massima predefinita, espressa in byte, delle istanze di Cookie che possono essere contenute nel CookieContainer.Represents the default maximum size, in bytes, of the Cookie instances that the CookieContainer can hold. Questo campo è costante.This field is constant.

DefaultCookieLimit

Rappresenta il numero massimo predefinito di istanze di Cookie che possono essere contenute nel CookieContainer.Represents the default maximum number of Cookie instances that the CookieContainer can hold. Questo campo è costante.This field is constant.

DefaultPerDomainCookieLimit

Rappresenta il numero massimo predefinito di istanze di Cookie a cui è possibile che un CookieContainer faccia riferimento per ogni dominio.Represents the default maximum number of Cookie instances that the CookieContainer can reference per domain. Questo campo è costante.This field is constant.

Proprietà

Capacity

Ottiene o imposta il numero di istanze di Cookie che possono essere contenute in CookieContainer.Gets or sets the number of Cookie instances that a CookieContainer can hold.

Count

Ottiene il numero di istanze di Cookie contenute attualmente in un CookieContainer.Gets the number of Cookie instances that a CookieContainer currently holds.

MaxCookieSize

Rappresenta la lunghezza massima consentita di un Cookie.Represents the maximum allowed length of a Cookie.

PerDomainCapacity

Ottiene o imposta il numero di istanze di Cookie che possono essere contenute in un CookieContainer per dominio.Gets or sets the number of Cookie instances that a CookieContainer can hold per domain.

Metodi

Add(Cookie)

Aggiunge un oggetto Cookie a un oggetto CookieContainer.Adds a Cookie to a CookieContainer. Questo metodo utilizza il dominio di Cookie per determinare quale insieme di dominio associare al Cookie.This method uses the domain from the Cookie to determine which domain collection to associate the Cookie with.

Add(CookieCollection)

Aggiunge il contenuto di un CookieCollection al CookieContainer.Adds the contents of a CookieCollection to the CookieContainer.

Add(Uri, Cookie)

Aggiunge un Cookie al CookieContainer per un determinato URI.Adds a Cookie to the CookieContainer for a particular URI.

Add(Uri, CookieCollection)

Aggiunge il contenuto di un CookieCollection al CookieContainer per un determinato URI.Adds the contents of a CookieCollection to the CookieContainer for a particular URI.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetCookieHeader(Uri)

Ottiene l'intestazione HTTP del cookie che contiene i cookie HTTP che rappresentano le istanze di Cookie associate a uno specifico URI.Gets the HTTP cookie header that contains the HTTP cookies that represent the Cookie instances that are associated with a specific URI.

GetCookies(Uri)

Ottiene un CookieCollection in cui sono contenute le istanze di Cookie associate a un URI specifico.Gets a CookieCollection that contains the Cookie instances that are associated with a specific URI.

GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
SetCookies(Uri, String)

Aggiunge le istanze di Cookie per uno o più cookie da un'intestazione HTTP al CookieContainer per uno specifico URI.Adds Cookie instances for one or more cookies from an HTTP cookie header to the CookieContainer for a specific URI.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Si applica a

Vedi anche