HttpClient.DefaultRequestVersion 屬性

定義

命名空間:

System.Net.Http

組件:

netstandard.dll, System.Net.Http.dll

來源:

HttpClient.cs

取得或設定此實例後續請求 HttpClient 所使用的預設 HTTP 版本。

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

屬性值

Version

這是使用此實例提出的任何請求 HttpClient 的預設版本。

例外狀況

ArgumentNullException

在集合運算中， DefaultRequestVersion 為 null。

InvalidOperationException

該 HttpClient 實例已經啟動了一個或多個請求。

ObjectDisposedException

HttpClient該實例已經被處理掉了。

備註

DefaultRequestVersion 預設為 HttpVersion.Version11。

該DefaultRequestVersion屬性指定了當它構造 HttpRequestMessage to send 時，對於使用此HttpClient實例發送請求所用的預設 HTTP 版本，特別是針對呼叫如 DeleteAsync、 GetAsync、 PatchAsyncPutAsyncGetByteArrayAsyncGetStreamAsyncGetStringAsyncPostAsync等方法。

這個 DefaultRequestVersion 性質不適用於方法 SendAsync 。 HttpRequestMessage作為參數傳遞給方法SendAsync的參數有自己的Version屬性，用以控制用於請求的 HTTP 版本。

只要實HttpClient例尚未開始任何請求，該DefaultRequestVersion屬性即可更改。