HttpWebRequest.Host Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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, setPublic Property Host As StringValor da propriedade
O valor do cabeçalho host na solicitação HTTP.
Exceções
O cabeçalho host não pode ser definido como null.
O cabeçalho host não pode ser definido como um valor inválido.
O cabeçalho host não pode ser definido depois que o HttpWebRequest já começou a ser enviado.
Comentários
Cuidado
WebRequest, HttpWebRequeste ServicePointWebClient são obsoletos e você não deve usá-los para um novo desenvolvimento. Use HttpClient em seu lugar.
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 da 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 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 o cache de áreas, 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.
