HttpClient.DefaultRequestHeaders 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 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 HttpRequestHeaderCollectionValeur de propriété
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.