HttpWebRequest.Host Propriété

Définition

Espace de noms:

System.Net

Assembly:

System.Net.Requests.dll

Assembly:

System.dll

Assembly:

netstandard.dll

Obtient ou définit la valeur d’en-tête Hôte à utiliser dans une requête HTTP indépendante de l’URI de la requête.

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

Valeur de propriété

String

Valeur d'en-tête Hôte dans la requête HTTP.

Exceptions

ArgumentNullException

Impossible de définir l’en-tête de l’hôte sur null.

ArgumentException

Impossible de définir l’en-tête de l’hôte sur une valeur non valide.

InvalidOperationException

L’en-tête de l’hôte ne peut pas être défini une fois que l’envoi de la HttpWebRequest a commencé.

Remarques

La Host propriété peut être utilisée pour définir la valeur d’en-tête hôte à utiliser dans une requête HTTP indépendante de l’URI de requête. La Host propriété peut se composer d’un nom d’hôte et d’un numéro de port facultatif. Un en-tête hôte sans informations de port implique le port par défaut du service demandé (port 80 pour une URL HTTP, par exemple).

Le format de spécification d’un hôte et d’un port doit suivre les règles de la section 14.23 de RFC2616 publiée par l’IETF. Un exemple conforme à ces exigences qui spécifie un port de 8080 serait la valeur suivante pour la Host propriété :

www.contoso.com:8080

L’utilisation de la Host propriété pour spécifier explicitement une valeur d’en-tête hôte personnalisée affecte également les zones de mise en cache, de cookies et d’authentification. Lorsqu’une application fournit des informations d’identification pour un préfixe d’URI spécifique, les applications doivent s’assurer d’utiliser l’URI contenant la valeur de l’en-tête hôte, et non du serveur cible dans l’URI. La clé utilisée lors de la mise en cache des ressources utilise la valeur d’en-tête hôte plutôt que l’URI de requête. Les cookies sont stockés dans un CookieContainer et regroupés logiquement par le nom de domaine du serveur. Si l’application spécifie un en-tête Hôte, cette valeur sera utilisée comme domaine.

Si la Host propriété n’est pas définie, la valeur d’en-tête hôte à utiliser dans une requête HTTP est basée sur l’URI de requête.