共用方式為


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 實例上設定。

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。

適用於

另請參閱