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 プロパティは、HttpClient インスタンスの特定のヘッダーを取得または設定するために使用できる HttpRequestHeaderCollection オブジェクトを返します。 このプロパティに設定された HTTP ヘッダーは、この HttpClient インスタンスで送信されるすべての要求メッセージで送信され、各 HttpRequestMessage インスタンスで設定する必要はありません。

HttpRequestMessage オブジェクトの Headers プロパティは、特定の HTTP 要求の特定のヘッダーを取得または設定するために使用できる HttpRequestHeaderCollection オブジェクトを返します。

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