HttpWebRequest.Host Propiedad

Definición

Obtiene o establece el valor del encabezado Host que se va a usar en una solicitud HTTP independiente del identificador URI de la 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

Valor del encabezado Host de 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.

El encabezado host no se puede establecer después de que empiece a enviarse la HttpWebRequest.

Comentarios

La Host propiedad se puede usar para establecer el valor del encabezado host que se usará en una solicitud HTTP independiente del URI de solicitud. La Host propiedad 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 publicada por el IETF. Un ejemplo que cumpla estos requisitos que especifica un puerto de 8080 sería el siguiente valor para la Host propiedad :

www.contoso.com:8080

El uso de la Host propiedad 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 un CookieContainer nombre de dominio del servidor y se agrupan lógicamente. Si la aplicación especifica un encabezado host, este valor se usará como dominio.

Si no se establece la Host propiedad, el valor del encabezado host que se va a usar en una solicitud HTTP se basa en el URI de la solicitud.

Se aplica a