HttpWebRequest.Host Propriedade

Definição

Namespace:

System.Net

Assembly:

System.Net.Requests.dll

Origem:

HttpWebRequest.cs

Obtém ou define o valor de cabeçalho do Host a ser usado em uma solicitação HTTP, independente do URI de solicitação.

public:
 property System::String ^ Host { System::String ^ get(); void set(System::String ^ value); };

public string Host { get; set; }

member this.Host : string with get, set

Public Property Host As String

Valor da propriedade

String

O valor do cabeçalho de Host na solicitação HTTP.

Exceções

ArgumentNullException

O cabeçalho do Host não pode ser definido como null.

ArgumentException

O cabeçalho do Host não pode ser definido com um valor inválido.

InvalidOperationException

O cabeçalho do Host não pode ser definido após o HttpWebRequest já ter começado o envio.

Comentários

A Host propriedade pode ser usada para definir o valor do cabeçalho host a ser usado em uma solicitação HTTP independente do URI de solicitação. A Host propriedade pode consistir em um nome de host e um número de porta opcional. Um cabeçalho host sem informações de porta implica a porta padrão para o serviço solicitado (porta 80 para uma URL HTTP, por exemplo).

O formato para especificar um host e uma porta deve seguir as regras na seção 14.23 de RFC2616 publicadas pelo IETF. Um exemplo de conformidade com esses requisitos que especifica uma porta de 8080 seria o seguinte valor para a Host propriedade:

www.contoso.com:8080

Usar a Host propriedade para especificar explicitamente um valor de cabeçalho host personalizado também afeta áreas de cache, cookies e autenticação. Quando um aplicativo fornece credenciais para um prefixo de URI específico, os aplicativos precisam usar o URI que contém o valor do cabeçalho Host, não o servidor de destino no URI. A chave usada ao armazenar recursos em cache usa o valor do cabeçalho Host em vez do URI da solicitação. Os cookies são armazenados em um CookieContainer e agrupados logicamente pelo nome de domínio do servidor. Se o aplicativo especificar um cabeçalho host, esse valor será usado como domínio.

Se a Host propriedade não estiver definida, o valor do cabeçalho host a ser usado em uma solicitação HTTP será baseado no URI da solicitação.