HttpWebRequest.Host Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define o valor do cabeçalho Host para usar num pedido HTTP independente do URI do pedido.
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 de Propriedade
O valor do cabeçalho Host no pedido HTTP.
Exceções
O cabeçalho Host não pode ser definido para null.
O cabeçalho Host não pode ser definido para um valor inválido.
O cabeçalho Host não pode ser definido depois de já HttpWebRequest ter começado a ser enviado.
Observações
Atenção
WebRequest, HttpWebRequest, ServicePoint, e WebClient são obsoletos, e não deves usá-los para novos desenvolvimentos. Utilize HttpClient em substituição.
A Host propriedade pode ser usada para definir o valor do cabeçalho Host a ser usado num pedido HTTP independente do URI do pedido. A Host propriedade pode consistir num nome de host e num número de porta opcional. Um cabeçalho Host sem informação de porta implica a porta padrão para o serviço solicitado (porta 80 para um URL HTTP, por exemplo).
O formato para especificar um hospedeiro e uma porta deve seguir as regras da secção 14.23 da RFC2616 publicada pelo IETF. Um exemplo que cumpre estes requisitos e 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 personalizado do Host também afeta áreas como cache, cookies e autenticação. Quando uma aplicação fornece credenciais para um prefixo de URI específico, as aplicações têm de garantir que usam o URI que contém o valor do cabeçalho Host, e não o servidor alvo no URI. A chave usada na cache de recursos utiliza o valor do cabeçalho Host em vez do URI do pedido. Os cookies são armazenados e CookieContainer agrupados logicamente pelo nome de domínio do servidor. Se a aplicação especificar um cabeçalho Host, então esse valor será usado como domínio.
Se a Host propriedade não estiver definida, então o valor do cabeçalho Host a usar num pedido HTTP baseia-se no URI do pedido.