HttpClient.DefaultRequestHeaders Propriété

Définition

Espace de noms:

Windows.Web.Http

Obtient une collection d’en-têtes qui doivent être envoyés avec chaque requête. Pour obtenir des conseils de programmation pour la classe HttpClient et des exemples de code, consultez la rubrique conceptuelle HttpClient .

public:
 property HttpRequestHeaderCollection ^ DefaultRequestHeaders { HttpRequestHeaderCollection ^ get(); };

HttpRequestHeaderCollection DefaultRequestHeaders();

public HttpRequestHeaderCollection DefaultRequestHeaders { get; }

var httpRequestHeaderCollection = httpClient.defaultRequestHeaders;

Public ReadOnly Property DefaultRequestHeaders As HttpRequestHeaderCollection

Valeur de propriété

HttpRequestHeaderCollection

En-têtes qui doivent être envoyés avec chaque requête.

Remarques

La propriété DefaultRequestHeaders renvoie un objet HttpRequestHeaderCollection qui peut être utilisé pour obtenir ou définir les en-têtes spécifiques sur le instance HttpClient. Les en-têtes HTTP définis sur cette propriété seront envoyés sur tous les messages de requête envoyés sur ce instance HttpClient et n’ont pas besoin d’être définis sur chaque instance HttpRequestMessage.

La propriété Headers de l’objet HttpRequestMessage renvoie un objet HttpRequestHeaderCollection qui peut être utilisé pour obtenir ou définir les en-têtes spécifiques sur une requête HTTP spécifique.

La propriété DefaultRequestHeaders représente les en-têtes qu’un développeur d’application peut définir, pas tous les en-têtes qui peuvent éventuellement être envoyés avec la demande. HttpBaseProtocolFilter ajoute des en-têtes supplémentaires.

Avertissement

Dans les versions antérieures à Windows 10, la définition de certains en-têtes sur NULL a entraîné la définition d’une valeur d’en-tête vide, ce qui a provoqué un échec inattendu lors des appels ultérieurs à GetAsync. À compter de Windows 10, la définition de l’un des en-têtes suivants sur NULL entraîne leur suppression complète de la demande, afin que les en-têtes restants soient valides.

• Autorisation
• Date
• À partir
• Host
• If-Modified-Since
• If-Unmodified-Since
• Max-Forwards
• Proxy-Authorization
• Référant

Si vous écrivez pour des versions antérieures à Windows 10, ne définissez pas ces valeurs d’en-tête sur NULL.

Voir aussi

• HttpClient