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 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
O valor do cabeçalho de Host na solicitação HTTP.
Exceções
O cabeçalho do Host não pode ser definido como null
.
O cabeçalho do Host não pode ser definido com um valor inválido.
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.
Aplica-se a
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de