Cookie Construtores

  • Referência

Definição

Namespace:
System.Net
Assembly:
System.Net.Primitives.dll
Assembly:
System.dll
Assembly:
netstandard.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.
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 propriedade Name deve ser inicializada antes de usar uma instância da classe Cookie.

Aplica-se a

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

Aplica-se a

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

Aplica-se a

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

Aplica-se a