Поделиться через


HttpClient.DefaultRequestHeaders Свойство

Определение

Возвращает коллекцию заголовков, которые должны отправляться с каждым запросом. Руководство по программированию для класса HttpClient и примеры кода см. в разделе о концепции HttpClient .

public:
 property HttpRequestHeaderCollection ^ DefaultRequestHeaders { HttpRequestHeaderCollection ^ get(); };
HttpRequestHeaderCollection DefaultRequestHeaders();
public HttpRequestHeaderCollection DefaultRequestHeaders { get; }
var httpRequestHeaderCollection = httpClient.defaultRequestHeaders;
Public ReadOnly Property DefaultRequestHeaders As HttpRequestHeaderCollection

Значение свойства

Заголовки, которые должны отправляться с каждым запросом.

Комментарии

Свойство DefaultRequestHeaders возвращает объект HttpRequestHeaderCollection , который можно использовать для получения или задания определенных заголовков в экземпляре HttpClient . Заголовки HTTP, заданные для этого свойства, будут отправляться во все сообщения запросов, отправленные в этом экземпляре HttpClient , и их не нужно задавать для каждого экземпляра HttpRequestMessage .

Свойство Headers объекта HttpRequestMessage возвращает объект HttpRequestHeaderCollection , который можно использовать для получения или задания определенных заголовков в определенном HTTP-запросе.

Свойство DefaultRequestHeaders представляет заголовки, которые может задать разработчик приложения, а не все заголовки, которые в конечном итоге могут быть отправлены вместе с запросом. HttpBaseProtocolFilter добавит несколько дополнительных заголовков.

Предупреждение

В версиях, предшествующих Windows 10, установка для некоторых заголовков значения NULL приводила к установке пустого значения заголовка, что привело к непредвиденному сбою при последующих вызовах GetAsync. Начиная с Windows 10 установка любого из следующих заголовков значения NULL приводит к их удалению из запроса полностью, чтобы оставшиеся заголовки были действительными.

  • Авторизация
  • Date
  • Исходный тип
  • Узел
  • If-Modified-Since
  • If-Unmodified-Since
  • Max-Forwards
  • Proxy-Authorization
  • Referer

Если вы пишете для версий, предшествующих Windows 10, не устанавливайте для этих значений заголовков значение NULL.

Применяется к

См. также раздел