HttpWebRequest.Host Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit la valeur d’en-tête de l’hôte à utiliser dans une requête HTTP indépendante de l’URI de 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, setPublic Property Host As StringValeur de propriété
Valeur d’en-tête de l’hôte dans la requête HTTP.
Exceptions
L’en-tête hôte ne peut pas être défini sur null.
L’en-tête hôte ne peut pas être défini sur une valeur non valide.
L’en-tête hôte ne peut pas être défini une fois que le HttpWebRequest a déjà commencé à être envoyé.
Remarques
Prudence
WebRequest, HttpWebRequest, ServicePointet WebClient sont obsolètes et vous ne devez pas les utiliser pour le nouveau développement. Utilisez HttpClient à la place.
La propriété Host peut être utilisée pour définir la valeur d’en-tête de l’hôte à utiliser dans une requête HTTP indépendamment de l’URI de la requête. La propriété Host 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 respecter les règles de la section 14.23 de RFC2616 publiées par l’IETF. Un exemple conforme à ces exigences qui spécifient un port de 8080 serait la valeur suivante pour la propriété Host :
www.contoso.com:8080
L’utilisation de la propriété Host pour spécifier explicitement une valeur d’en-tête hôte personnalisée affecte également la mise en cache, les cookies et l’authentification des zones. 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 d’hôte, et non le serveur cible dans l’URI. La clé utilisée lors de la mise en cache des ressources utilise la valeur d’en-tête de l’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 propriété Host n’est pas définie, la valeur d’en-tête de l’hôte à utiliser dans une requête HTTP est basée sur l’URI de la requête.
