HttpClient.DefaultRequestVersion プロパティ

定義

この HttpClient インスタンスによって行われる後続の要求で使用される、既定の HTTP バージョンを取得または設定します。Gets or sets the default HTTP version used on subsequent requests made by this HttpClient instance.

public:
 property Version ^ DefaultRequestVersion { Version ^ get(); void set(Version ^ value); };
public Version DefaultRequestVersion { get; set; }
member this.DefaultRequestVersion : Version with get, set
Public Property DefaultRequestVersion As Version

プロパティ値

この HttpClient インスタンスを使用して行われたすべての要求に使用する既定のバージョン。The default version to use for any requests made with this HttpClient instance.

例外

設定操作で、DefaultRequestVersionnull です。In a set operation, DefaultRequestVersion is null.

HttpClient インスタンスにより 1 つ以上の要求が既に開始されています。The HttpClient instance has already started one or more requests.

HttpClient インスタンスは既に破棄されています。The HttpClient instance has already been disposed.

注釈

DefaultRequestVersion は既定では HttpVersion.Version11 です。DefaultRequestVersion is HttpVersion.Version11 by default.

DefaultRequestVersion プロパティは、送信する HttpRequestMessage を構築するときに、この HttpClient インスタンスを使用して送信される要求に使用する既定の HTTP バージョンを指定します。具体的には、DeleteAsyncGetAsyncGetByteArrayAsyncGetStreamAsyncGetStringAsyncPatchAsyncPostAsyncPutAsyncなどのメソッドの呼び出しを使用します。The DefaultRequestVersion property specifies the default HTTP version to use for requests sent using this HttpClient instance when it constructs the HttpRequestMessage to send, specifically with calls to methods such as DeleteAsync, GetAsync, GetByteArrayAsync, GetStreamAsync, GetStringAsync, PatchAsync, PostAsync, and PutAsync.

DefaultRequestVersion プロパティは、SendAsync メソッドには適用されません。The DefaultRequestVersion property doesn't apply to the SendAsync method. SendAsync メソッドに引数として渡される HttpRequestMessage パラメーターには、要求に使用される HTTP バージョンを制御する独自の Version プロパティがあります。The HttpRequestMessage parameter passed as the argument to the SendAsync method has its own Version property that controls the HTTP version used for the request.

DefaultRequestVersion プロパティは、HttpClient インスタンスが要求を開始していない限り変更できます。The DefaultRequestVersion property can be changed as long as the HttpClient instance has not started any request.

適用対象