CookieContainer.Add Método

Definição

Namespace:

System.Net

Assembly:

System.Net.Primitives.dll

Adiciona um Cookie a um CookieContainer.

Sobrecargas

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.

Add(Cookie)

Origem:

CookieContainer.cs

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.

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 de cookie é null ou uma cadeia de caracteres vazia ("").

CookieException

cookie é maior que maxCookieSize.

- ou -

o domínio de cookie 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 liberar espaço da cookies seguinte maneira: se houver instâncias expiradas, elas serão limpas. Caso contrário, ou se mais espaço for necessário, 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 para um 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

O uri é null ou o cookie é null.

CookieException

cookie é maior que maxCookieSize.

- ou -

O domínio para cookie 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 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 a Version propriedade de um Cookie for Netscape, a Path propriedade do Cookie, se não for definida 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 para um 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 para um dos cookies em cookies é null.

CookieException

Um dos cookies no cookies contém 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 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 Capacitya , 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