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 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é
Valeur d'en-tête Hôte dans la requête HTTP.
Exceptions
Impossible de définir l’en-tête de l’hôte sur null
.
Impossible de définir l’en-tête de l’hôte sur une valeur non valide.
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 de l’hôte à utiliser dans une requête HTTP indépendante de l’URI de la 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 d’hôte sans informations de port implique le port par défaut pour le 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ées par l’IETF. Un exemple de conformité à 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 d’hôte personnalisée affecte également la mise en cache des zones, les cookies et l’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 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 sont regroupés logiquement par nom de domaine du serveur. Si l’application spécifie un en-tête d’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 de l’hôte à utiliser dans une requête HTTP est basée sur l’URI de la requête.
S’applique à
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour