CookieContainer.Add Método

Definição

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)

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

cookie é null.

O domínio de cookie é null ou uma cadeia de caracteres vazia ("").

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 excedido 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

Aplica-se a

Add(CookieCollection)

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

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

Aplica-se a

Add(Uri, Cookie)

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

O uri é null ou o cookie é null.

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 para 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 é Netscape, a Path propriedade do Cookie, se não definido explicitamente, é derivada do URI e é 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

Aplica-se a

Add(Uri, CookieCollection)

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

cookies é null.

O domínio para um dos cookies em cookies é null.

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 para 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

Aplica-se a