HttpWebRequest.Host Propiedad

Definición

Espacio de nombres:

System.Net

Ensamblado:

System.Net.Requests.dll

Source:

HttpWebRequest.cs

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, set

Public Property Host As String

Valor de propiedad

String

Valor del encabezado host en la solicitud HTTP.

Excepciones

ArgumentNullException

El encabezado Host no se puede establecer en null.

ArgumentException

El encabezado Host no se puede establecer en un valor no válido.

InvalidOperationException

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.