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
• 寄件者
• Host
• If-Modified-Since
• If-Unmodified-Since
• Max-Forwards
• Proxy-Authorization
• Referer

如果您要在Windows 10之前針對版本撰寫，請勿將這些標頭值設定為 Null。

另請參閱

• HttpClient