HttpClient.DefaultRequestHeaders 属性

定义

命名空间:

Windows.Web.Http

获取应随每个请求一起发送的标头的集合。 有关 HttpClient 类的编程指南和代码示例，请参阅 HttpClient 概念主题。

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

HttpRequestHeaderCollection DefaultRequestHeaders();

public HttpRequestHeaderCollection DefaultRequestHeaders { get; }

var httpRequestHeaderCollection = httpClient.defaultRequestHeaders;

Public ReadOnly Property DefaultRequestHeaders As HttpRequestHeaderCollection

属性值

HttpRequestHeaderCollection

应随每个请求一起发送的标头。

注解

DefaultRequestHeaders 属性返回一个 HttpRequestHeaderCollection 对象，该对象可用于获取或设置 HttpClient 实例上的特定标头。 针对此属性设置的 HTTP 标头将在此 HttpClient 实例上发送的所有请求消息上发送，无需在每个 HttpRequestMessage 实例上设置。

HttpRequestMessage 对象上的 Headers 属性返回一个 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。

另请参阅

• HttpClient