HttpWebRequest.Host Propriedade

Definição

Namespace:

System.Net

Assembly:

System.Net.Requests.dll

Origem:

HttpWebRequest.cs

Obtém ou define o valor do cabeçalho host a ser usado em uma solicitação HTTP independente do URI da 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 host na solicitação HTTP.

Exceções

ArgumentNullException

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

ArgumentException

O cabeçalho host não pode ser definido como um valor inválido.

InvalidOperationException

O cabeçalho host não pode ser definido depois que o HttpWebRequest já começou a ser enviado.

Comentários

Cuidado

WebRequest, HttpWebRequest, ServicePointe WebClient estão obsoletos e você não deve usá-los para um novo desenvolvimento. Em vez disso, use HttpClient.

A propriedade Host pode ser usada para definir o valor do cabeçalho host a ser usado em uma solicitação HTTP independente do URI da solicitação. A propriedade Host 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 8080 seria o seguinte valor para a propriedade Host:

www.contoso.com:8080

Usar a propriedade Host 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 propriedade Host 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.