Cookie Construtores

Definição

Espaço de Nomes:
System.Net
Assemblagens:
System.dll, System.Net.Primitives.dll
Assemblagem:
System.dll
Assemblagem:
System.Net.Primitives.dll
Assemblagem:
netstandard.dll

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

Sobrecargas

Name Description
Cookie()

Inicializa uma nova instância da Cookie classe.
Cookie(String, String)

Inicializa uma nova instância da Cookie classe com um especificado Name e Value.
Cookie(String, String, String)

Inicializa uma nova instância da Cookie classe com um especificado Name, Value, e Path.
Cookie(String, String, String, String)

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

Inicializa uma nova instância da Cookie classe.

public:
 Cookie();
public Cookie();
Public Sub New ()

Observações

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

Aplica-se a

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

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 no interior name: sinal igual, ponto e vírgula, vírgula, nova linha (\n), retorno (\r), tab (\t) e carácter de espaço. O símbolo do dólar ("$") não pode ser o primeiro caractere.

value
String

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

Exceções

CookieException

O name parâmetro é null.

-ou-

O name parâmetro é de comprimento zero.

-ou-

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

-ou-

O value parâmetro é null .

-ou -

O value parâmetro contém uma cadeia não incluída entre aspas que contém um carácter inválido.

Observações

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

O parâmetro value para um Cookie não pode ser uma referência null (Nada em Visual Basic). Os caracteres ponto e vírgula (";") e vírgula (",") estão reservados e não podem ser passados no value parâmetro a menos que a cadeia passada no value parâmetro esteja entre aspas duplas. Assim, o seguinte construtor de exemplo teria sucesso, mas quando tentares adicionar isto 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 seguinte construtor com estes caracteres especiais escapados 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 carácter vírgula é usado como delimitador entre cookies separados na mesma linha.

Ver também

Aplica-se a

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

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 no interior name: sinal igual, ponto e vírgula, vírgula, nova linha (\n), retorno (\r), tab (\t) e carácter de espaço. O símbolo do dólar ("$") não pode ser o primeiro caractere.

value
String

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

path
String

O subconjunto de URIs no servidor de origem a que isto Cookie se aplica. O valor padrão é "/".

Exceções

CookieException

O name parâmetro é null.

-ou-

O name parâmetro é de comprimento zero.

-ou-

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

-ou-

O value parâmetro é null .

-ou -

O value parâmetro contém uma cadeia não incluída entre aspas que contém um carácter inválido.

Observações

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

O parâmetro value para um Cookie não pode ser uma referência null (Nada em Visual Basic). Os caracteres ponto e vírgula (";") e vírgula (",") estão reservados e não podem ser passados no value parâmetro a menos que a cadeia passada no value parâmetro esteja entre aspas duplas. Assim, o seguinte construtor de exemplo teria sucesso, mas quando tentares adicionar isto 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 seguinte construtor com estes caracteres especiais escapados 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 carácter vírgula é usado como delimitador entre cookies separados na mesma linha.

Ver também

Aplica-se a

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

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 no interior name: sinal igual, ponto e vírgula, vírgula, nova linha (\n), retorno (\r), tab (\t) e carácter de espaço. O símbolo do dólar ("$") não pode ser o primeiro caractere.

value
String

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

path
String

O subconjunto de URIs no servidor de origem a que isto Cookie se aplica. O valor padrão é "/".

domain
String

O domínio opcional da internet para o qual isto Cookie é válido. O valor padrão é o host de onde isto Cookie foi recebido.

Exceções

CookieException

O name parâmetro é null.

-ou-

O name parâmetro é de comprimento zero.

-ou-

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

-ou-

O value parâmetro é null .

-ou -

O value parâmetro contém uma cadeia não incluída entre aspas que contém um carácter inválido.

Observações

O padrão dos domain parâmetros e path usa a cadeia vazia ("").

O parâmetro value para um Cookie não pode ser uma referência null (Nada em Visual Basic). Os caracteres ponto e vírgula (";") e vírgula (",") estão reservados e não podem ser passados no value parâmetro a menos que a cadeia passada no value parâmetro esteja entre aspas duplas. Assim, o seguinte construtor de exemplo teria sucesso, mas quando tentares adicionar isto 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 seguinte construtor com estes caracteres especiais escapados 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 carácter vírgula é usado como delimitador entre cookies separados na mesma linha.

Ver também

Aplica-se a