Compartilhar via


Cookie Construtores

Definição

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.

Origem:
Cookie.cs
Origem:
Cookie.cs
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 .

Aplica-se a

Origem:
Cookie.cs
Origem:
Cookie.cs
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);
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

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

Aplica-se a

Origem:
Cookie.cs
Origem:
Cookie.cs
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);
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

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

Aplica-se a

Origem:
Cookie.cs
Origem:
Cookie.cs
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);
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

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

Aplica-se a