HttpWebRequest.Host Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece el valor del encabezado host que se va a usar en una solicitud HTTP independiente del URI de solicitud.
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 propiedad
Valor del encabezado host en la solicitud HTTP.
Excepciones
El encabezado Host no se puede establecer en null.
El encabezado Host no se puede establecer en un valor no válido.
No se puede establecer el encabezado host después de que ya se haya iniciado el envío del HttpWebRequest.
Comentarios
Cautela
WebRequest, HttpWebRequest, ServicePointy WebClient están obsoletos y no debe usarlos para el nuevo desarrollo. Use HttpClient en su lugar.
La propiedad Host se puede usar para establecer el valor del encabezado host que se usará en una solicitud HTTP independiente del URI de solicitud. La propiedad Host puede constar de un nombre de host y un número de puerto opcional. Un encabezado host sin información de puerto implica el puerto predeterminado para el servicio solicitado (puerto 80 para una dirección URL HTTP, por ejemplo).
El formato para especificar un host y un puerto debe seguir las reglas de la sección 14.23 de RFC2616 publicadas por IETF. Un ejemplo que cumpla estos requisitos que especifica un puerto de 8080 sería el siguiente valor para la propiedad Host:
www.contoso.com:8080
El uso de la propiedad Host para especificar explícitamente un valor de encabezado host personalizado también afecta a las áreas de almacenamiento en caché, cookies y autenticación. Cuando una aplicación proporciona credenciales para un prefijo de URI específico, las aplicaciones deben asegurarse de usar el URI que contiene el valor del encabezado Host, no el servidor de destino en el URI. La clave que se usa al almacenar en caché los recursos usa el valor del encabezado host en lugar del URI de solicitud. Las cookies se almacenan en una CookieContainer y se agrupan lógicamente por el nombre de dominio del servidor. Si la aplicación especifica un encabezado host, este valor se usará como dominio.
Si no se establece la propiedad Host, el valor del encabezado host que se usará en una solicitud HTTP se basa en el URI de solicitud.
