Cookie Construtores

Definição

Namespace:

System.Net

Assembly:

System.Net.Primitives.dll

Inicializa uma nova instância da classe Cookie. Em geral, um aplicativo não precisa construir uma classe Cookie porque ele é criado automaticamente com base no cabeçalho Set-Cookie recebido com a resposta HTTP.

Sobrecargas

Cookie()	Inicializa uma nova instância da classe Cookie.
Cookie(String, String)	Inicializa uma nova instância da classe Cookie com o Name e o Value especificados.
Cookie(String, String, String)	Inicializa uma nova instância da classe Cookie com o Name, Value e Path especificados.
Cookie(String, String, String, String)	Inicializa uma nova instância da classe Cookie com o Name, Value, Path e Domain especificados.

Cookie()

Origem:

Cookie.cs

Inicializa uma nova instância da classe Cookie.

public:
 Cookie();

public Cookie ();

Public Sub New ()

Comentários

O construtor sem parâmetros inicializa todos os campos para seus valores padrão, usando cadeias de caracteres vazias ("") para name, value, pathe domain. Observe que pelo menos a Name propriedade deve ser inicializada antes de usar uma instância da Cookie classe .

Cookie(String, String)

Origem:

Cookie.cs

Inicializa uma nova instância da classe Cookie com o Name e o Value especificados.

public:
 Cookie(System::String ^ name, System::String ^ value);

public Cookie (string name, string? value);

new System.Net.Cookie : string * string -> System.Net.Cookie

Public Sub New (name As String, value As String)

Parâmetros

name

String

O nome de um Cookie. Os seguintes caracteres não devem ser usados dentro de name: sinal de igual, ponto-e-vírgula, vírgula, nova linha (\n), retorno (\r), guia (\t) e caractere de espaço. O caractere de cifrão ("$") não pode ser o primeiro caractere.

value

String

O valor de um Cookie. Os seguintes caracteres não devem ser usados dentro de value: ponto-e-vírgula, vírgula.

Exceções

CookieException

O parâmetro name é null.

- ou -

O parâmetro name é de tamanho zero.

- ou -

O parâmetro name contém um caractere inválido.

- ou -

O parâmetro value é null.

-ou-

O parâmetro value contém uma cadeia de caracteres fora de aspas que contém um caractere inválido.

Comentários

O padrão para o value parâmetro usa a cadeia de caracteres vazia ("").

O value parâmetro de um Cookie não deve ser uma null referência (Nothing no Visual Basic). Os caracteres ponto e vírgula (";") e vírgula (",") são reservados e não podem ser passados no value parâmetro, a menos que a cadeia de caracteres passada no parâmetro esteja entre aspas value duplas. Portanto, o construtor de exemplo a seguir teria êxito, mas quando você tentar adicioná-lo Cookie a uma CookieContainer instância com os Add(Cookie) métodos ou Add(Uri, Cookie) , a operação falhará e lançará uma exceção:

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "123,456");
cookie.Domain = "contoso.com";
new CookieContainer().Add(cookie);

No entanto, o construtor a seguir com esses caracteres especiais com escape criará um Cookie que pode ser adicionado a uma CookieContainer instância:

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "\"123,456\"");
cookie.Domain = "contoso.com";
new CookieContainer().Add(cookie);

O caractere de vírgula é usado como um delimitador entre cookies separados na mesma linha.

Confira também

• CookieCollection
• CookieContainer
• CookieException

Cookie(String, String, String)

Origem:

Cookie.cs

Inicializa uma nova instância da classe Cookie com o Name, Value e Path especificados.

public:
 Cookie(System::String ^ name, System::String ^ value, System::String ^ path);

public Cookie (string name, string? value, string? path);

new System.Net.Cookie : string * string * string -> System.Net.Cookie

Public Sub New (name As String, value As String, path As String)

Parâmetros

name

String

O nome de um Cookie. Os seguintes caracteres não devem ser usados dentro de name: sinal de igual, ponto-e-vírgula, vírgula, nova linha (\n), retorno (\r), guia (\t) e caractere de espaço. O caractere de cifrão ("$") não pode ser o primeiro caractere.

value

String

O valor de um Cookie. Os seguintes caracteres não devem ser usados dentro de value: ponto-e-vírgula, vírgula.

path

String

O subconjunto de URIs no servidor de origem ao qual este Cookie se aplica. O valor padrão é "/".

Exceções

CookieException

O parâmetro name é null.

- ou -

O parâmetro name é de tamanho zero.

- ou -

O parâmetro name contém um caractere inválido.

- ou -

O parâmetro value é null.

-ou-

O parâmetro value contém uma cadeia de caracteres fora de aspas que contém um caractere inválido.

Comentários

O padrão para o path parâmetro usa a cadeia de caracteres vazia ("").

O value parâmetro de um Cookie não deve ser uma null referência (Nothing no Visual Basic). Os caracteres ponto e vírgula (";") e vírgula (",") são reservados e não podem ser passados no value parâmetro, a menos que a cadeia de caracteres passada no parâmetro esteja entre aspas value duplas. Portanto, o construtor de exemplo a seguir teria êxito, mas quando você tentar adicioná-lo Cookie a uma CookieContainer instância com os Add(Cookie) métodos ou Add(Uri, Cookie) , a operação falhará e lançará uma exceção:

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "123,456", "");
cookie.Domain = "contoso.com";
new CookieContainer().Add(cookie);

No entanto, o construtor a seguir com esses caracteres especiais com escape criará um Cookie que pode ser adicionado a uma CookieContainer instância:

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "\"123,456\"", "");
cookie.Domain = "contoso.com";
new CookieContainer().Add(cookie);

O caractere de vírgula é usado como um delimitador entre cookies separados na mesma linha.

Confira também

• CookieCollection
• CookieContainer
• CookieException

Cookie(String, String, String, String)

Origem:

Cookie.cs

Inicializa uma nova instância da classe Cookie com o Name, Value, Path e Domain especificados.

public:
 Cookie(System::String ^ name, System::String ^ value, System::String ^ path, System::String ^ domain);

public Cookie (string name, string? value, string? path, string? domain);

new System.Net.Cookie : string * string * string * string -> System.Net.Cookie

Public Sub New (name As String, value As String, path As String, domain As String)

Parâmetros

name

String

O nome de um Cookie. Os seguintes caracteres não devem ser usados dentro de name: sinal de igual, ponto-e-vírgula, vírgula, nova linha (\n), retorno (\r), guia (\t) e caractere de espaço. O caractere de cifrão ("$") não pode ser o primeiro caractere.

value

String

O valor de um objeto Cookie. Os seguintes caracteres não devem ser usados dentro de value: ponto-e-vírgula, vírgula.

path

String

O subconjunto de URIs no servidor de origem ao qual este Cookie se aplica. O valor padrão é "/".

domain

String

O domínio da Internet opcional para o qual este Cookie é válido. O valor padrão é o host do qual este Cookie foi recebido.

Exceções

CookieException

O parâmetro name é null.

- ou -

O parâmetro name é de tamanho zero.

- ou -

O parâmetro name contém um caractere inválido.

- ou -

O parâmetro value é null.

-ou-

O parâmetro value contém uma cadeia de caracteres fora de aspas que contém um caractere inválido.

Comentários

O padrão para os domain parâmetros e path usa a cadeia de caracteres vazia ("").

O value parâmetro de um Cookie não deve ser uma null referência (Nothing no Visual Basic). Os caracteres ponto e vírgula (";") e vírgula (",") são reservados e não podem ser passados no value parâmetro, a menos que a cadeia de caracteres passada no parâmetro esteja entre aspas value duplas. Portanto, o construtor de exemplo a seguir teria êxito, mas quando você tentar adicioná-lo Cookie a uma CookieContainer instância com os Add(Cookie) métodos ou Add(Uri, Cookie) , a operação falhará e lançará uma exceção:

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "123,456", "", "contoso.com");
new CookieContainer().Add(cookie);

No entanto, o construtor a seguir com esses caracteres especiais com escape criará um Cookie que pode ser adicionado a uma CookieContainer instância:

System.Net.Cookie cookie = new System.Net.Cookie("contoso", "\"123,456\"", "", "contoso.com");
new CookieContainer().Add(cookie);

O caractere de vírgula é usado como um delimitador entre cookies separados na mesma linha.

Confira também

• CookieCollection
• CookieContainer
• CookieException