HttpCookie(String, String, String) Construtor

Definição

Namespace:

Windows.Web.Http

Inicializa uma nova instância da classe HttpCookie com um nome, domínio e caminho especificados.

public:
 HttpCookie(Platform::String ^ name, Platform::String ^ domain, Platform::String ^ path);

 HttpCookie(winrt::hstring const& name, winrt::hstring const& domain, winrt::hstring const& path);

public HttpCookie(string name, string domain, string path);

function HttpCookie(name, domain, path)

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

Parâmetros

name

String

Platform::String

winrt::hstring

O nome do HttpCookie

domain

String

Platform::String

winrt::hstring

O domínio para o qual o HttpCookie é válido.

path

String

Platform::String

winrt::hstring

Os URIs aos quais o HttpCookie se aplica.

Comentários

O parâmetro name do HttpCookie não pode ser definido como nulo (Nothing no Visual Basic).

A propriedade deve ser um token, conforme definido em RFC 2616 e RFC 6265.

Os seguintes caracteres são usados como separadores e não podem ser usados no parâmetro name :

• paren esquerdo ('(')
• right paren (')')
• maior que ('>')
• menor que ('<')
• at sign ('@')
• vírgula (',')
• Ponto (';')
• dois-pontos (':')
• barra invertida ('\')
• aspas duplas ('"')
• barra ('/')
• colchete esquerdo ('[')
• colchete direito (']')
• ponto de interrogação ('?')
• sinal de igual ('=')
• colchete ondulado esquerdo ('{')
• colchete ondulado direito ('}')
• nova linha ('\n')
• return ('\r")
• espaço (' ')
• guia ('\t")

O parâmetro *domain * especifica os hosts aos quais o HttpCookie será enviado. Um cookie com um parâmetro *domain * de .contoso.com será enviado para o contoso.com domínio e todos os subdomínios (www.contoso.com e info.contoso.com, por exemplo).

Um cookie com um parâmetro *domain * de info.contoso.com não será enviado para contoso.com ou www.contoso.com, mas será enviado para info.contoso.com e todos os subdomínios (uk.info.contoso.com e us.info.contoso.com, por exemplo).

Se o parâmetro de domínio não for especificado, o HttpCookie será enviado somente para o host e subdomínios do host do qual esse cookie foi recebido.

O parâmetro path especifica o subconjunto de caminhos no servidor de origem ao qual este HttpCookie se aplica. Se esse parâmetro não for especificado, o caminho padrão corresponderá a qualquer caminho e o HttpCookie será enviado em todas as solicitações HTTP para o parâmetro *domain * especificado e todos os subdomínios.