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 um Name e Valueespecificados.
Cookie(String, String, String)	Inicializa uma nova instância da classe Cookie com um Name, Valuee Pathespecificados.
Cookie(String, String, String, String)	Inicializa uma nova instância da classe Cookie com um Name, Value, Pathe Domainespecificados.

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 propriedade Name deve ser inicializada antes de usar uma instância da classe Cookie.

Cookie(String, String)

Origem:

Cookie.cs

Inicializa uma nova instância da classe Cookie com um Name e Valueespecificados.

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 caracteres a seguir 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 sinal de dólar ("$") não pode ser o primeiro caractere.

value

String

O valor de um Cookie. Os caracteres a seguir 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 comprimento 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 não entre aspas que contém um caractere inválido.

Comentários

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

O parâmetro value para um Cookie não deve ser uma referência null (Nothing in Visual Basic). Os caracteres ponto e vírgula (";") e vírgula ("") são reservados e não podem ser passados no parâmetro value, a menos que a cadeia de caracteres passada no parâmetro value esteja entre aspas duplas. Portanto, o construtor de exemplo a seguir teria êxito, mas quando você tentar adicionar esse Cookie a uma instância de CookieContainer com os métodos Add(Cookie) 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 seguinte construtor com esses caracteres especiais escapados criará um Cookie que pode ser adicionado a uma instância CookieContainer:

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 um Name, Valuee Pathespecificados.

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 caracteres a seguir 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 sinal de dólar ("$") não pode ser o primeiro caractere.

value

String

O valor de um Cookie. Os caracteres a seguir 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 esse Cookie se aplica. O valor padrão é "/".

Exceções

CookieException

O parâmetro name é null.

-ou-

O parâmetro name é de comprimento 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 não entre aspas que contém um caractere inválido.

Comentários

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

O parâmetro value para um Cookie não deve ser uma referência null (Nothing in Visual Basic). Os caracteres ponto e vírgula (";") e vírgula ("") são reservados e não podem ser passados no parâmetro value, a menos que a cadeia de caracteres passada no parâmetro value esteja entre aspas duplas. Portanto, o construtor de exemplo a seguir teria êxito, mas quando você tentar adicionar esse Cookie a uma instância de CookieContainer com os métodos Add(Cookie) 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 seguinte construtor com esses caracteres especiais escapados criará um Cookie que pode ser adicionado a uma instância CookieContainer:

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 um Name, Value, Pathe Domainespecificados.

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 caracteres a seguir 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 sinal de dólar ("$") não pode ser o primeiro caractere.

value

String

O valor de um objeto Cookie. Os caracteres a seguir 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 esse Cookie se aplica. O valor padrão é "/".

domain

String

O domínio opcional da Internet para o qual esse 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 comprimento 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 não entre aspas que contém um caractere inválido.

Comentários

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

O parâmetro value para um Cookie não deve ser uma referência null (Nothing in Visual Basic). Os caracteres ponto e vírgula (";") e vírgula ("") são reservados e não podem ser passados no parâmetro value, a menos que a cadeia de caracteres passada no parâmetro value esteja entre aspas duplas. Portanto, o construtor de exemplo a seguir teria êxito, mas quando você tentar adicionar esse Cookie a uma instância de CookieContainer com os métodos Add(Cookie) 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 seguinte construtor com esses caracteres especiais escapados criará um Cookie que pode ser adicionado a uma instância CookieContainer:

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