CookieContainer.Add Método

Definição

Namespace:

System.Net

Assemblies:

netstandard.dll, System.Net.Primitives.dll

Adiciona um Cookie a um CookieContainer.

Sobrecargas

Nome	Description
Add(Cookie)	Adiciona um Cookie a um CookieContainer. Esse método usa o domínio do Cookie para determinar com qual coleção de domínios associar Cookie .
Add(CookieCollection)	Adiciona o conteúdo de um CookieCollection ao CookieContainer.
Add(Uri, Cookie)	Adiciona um Cookie ao CookieContainer URI específico.
Add(Uri, CookieCollection)	Adiciona o conteúdo de um CookieCollection ao CookieContainer URI específico.

Add(Cookie)

Origem:

CookieContainer.cs

Adiciona um Cookie a um CookieContainer. Esse método usa o domínio do Cookie para determinar com qual coleção de domínios associar Cookie .

public:
 void Add(System::Net::Cookie ^ cookie);

public void Add(System.Net.Cookie cookie);

member this.Add : System.Net.Cookie -> unit

Public Sub Add (cookie As Cookie)

Parâmetros

cookie

Cookie

O Cookie a ser adicionado ao CookieContainer.

Exceções

ArgumentNullException

cookie é null.

ArgumentException

O domínio é cookienull ou a cadeia de caracteres vazia ("").

CookieException

cookie é maior que maxCookieSize.

- ou -

o domínio para cookie o qual não é um URI válido.

Comentários

Se a Count propriedade for igual ou exceder a Capacity propriedade, uma ou mais Cookie instâncias serão removidas do contêiner antes de adicionar o cookie parâmetro. Instâncias suficientes Cookie são removidas para trazer Count abaixo Capacity da seguinte maneira: se houver instâncias expiradas no escopo determinado, elas serão limpas. Caso contrário, o menos usado CookieCollection recentemente será encontrado e removido do contêiner.

Confira também

• Cookie
• CookieCollection
• CookieContainer
• CookieException

Add(CookieCollection)

Origem:

CookieContainer.cs

Adiciona o conteúdo de um CookieCollection ao CookieContainer.

public:
 void Add(System::Net::CookieCollection ^ cookies);

public void Add(System.Net.CookieCollection cookies);

member this.Add : System.Net.CookieCollection -> unit

Public Sub Add (cookies As CookieCollection)

Parâmetros

cookies

CookieCollection

O CookieCollection a ser adicionado ao CookieContainer.

Exceções

ArgumentNullException

cookies é null.

Comentários

Se a Count propriedade for igual à Capacity propriedade, uma ou mais Cookie instâncias serão removidas do contêiner antes de adicionar o conteúdo do cookies parâmetro. Instâncias suficientes Cookie são removidas para abrir espaço da cookies seguinte maneira: se houver instâncias expiradas, elas serão limpas. Caso contrário, ou se for necessário mais espaço, o menos usado CookieCollection recentemente será encontrado e removido do contêiner.

Confira também

• Cookie
• CookieCollection
• CookieContainer
• CookieException

Add(Uri, Cookie)

Origem:

CookieContainer.cs

Adiciona um Cookie ao CookieContainer URI específico.

public:
 void Add(Uri ^ uri, System::Net::Cookie ^ cookie);

public void Add(Uri uri, System.Net.Cookie cookie);

member this.Add : Uri * System.Net.Cookie -> unit

Public Sub Add (uri As Uri, cookie As Cookie)

Parâmetros

uri

Uri

O URI do Cookie a ser adicionado ao CookieContainer.

cookie

Cookie

O Cookie a ser adicionado ao CookieContainer.

Exceções

ArgumentNullException

uri é null ou cookie é null.

CookieException

cookie é maior que maxCookieSize.

- ou -

O domínio para cookie o qual não é um URI válido.

Comentários

Se você adicionar uma Cookie instância para apenas um host específico, não defina a Domain propriedade da Cookie instância. Isso é definido automaticamente, com base no URI.

Se o URI corresponder ao seu domínio local e enviar a todos os hosts no domínio local, defina a Cookie.Domain propriedade como ".local". Caso contrário, verifique se ele corresponde ao nome do host usado no URI.

Se a Version propriedade de um Cookie for Netscape, a Path propriedade do Cookie, se não definido explicitamente, será derivada do URI e será o caminho completo do URI, incluindo o nome da página.

Se a Count propriedade for igual à Capacity propriedade, uma ou mais Cookie instâncias serão removidas do contêiner antes de adicionar o cookie parâmetro. Instâncias suficientes Cookie são removidas para trazer Count abaixo Capacity da seguinte maneira: se houver instâncias expiradas no escopo, elas serão limpas. Caso contrário, o menos usado CookieCollection recentemente será encontrado e removido do contêiner.

Confira também

• Cookie
• CookieCollection
• CookieContainer
• CookieException

Add(Uri, CookieCollection)

Origem:

CookieContainer.cs

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

public:
 void Add(Uri ^ uri, System::Net::CookieCollection ^ cookies);

public void Add(Uri uri, System.Net.CookieCollection cookies);

member this.Add : Uri * System.Net.CookieCollection -> unit

Public Sub Add (uri As Uri, cookies As CookieCollection)

Parâmetros

uri

Uri

O URI do CookieCollection a ser adicionado ao CookieContainer.

cookies

CookieCollection

O CookieCollection a ser adicionado ao CookieContainer.

Exceções

ArgumentNullException

cookies é null.

ArgumentException

O domínio de um dos cookies é cookiesnull.

CookieException

Um dos cookies contém cookies um domínio inválido.

Comentários

Se você adicionar uma Cookie instância para apenas um host específico, não defina a Domain propriedade da Cookie instância. Isso é definido automaticamente, com base no URI.

Se o URI corresponder ao seu domínio local e enviar a todos os hosts no domínio local, defina a CookieDomain propriedade como ".local". Caso contrário, verifique se ele corresponde ao nome do host usado no URI.

Se Count for igual Capacity, uma ou mais Cookie instâncias serão removidas do contêiner antes de adicionar o cookie parâmetro. Instâncias suficientes Cookie são removidas para trazer Count abaixo Capacity da seguinte maneira: se houver instâncias expiradas no escopo, elas serão limpas. Caso contrário, o menos usado CookieCollection recentemente será encontrado e removido do contêiner.

Confira também

• Cookie
• CookieCollection
• CookieContainer
• CookieException