HttpClient.Timeout 屬性

定義

命名空間:

System.Net.Http

組件:

System.Net.Http.dll

來源:

HttpClient.cs

取得或設定要求逾時前等候的時間長度。

public:
 property TimeSpan Timeout { TimeSpan get(); void set(TimeSpan value); };

public TimeSpan Timeout { get; set; }

member this.Timeout : TimeSpan with get, set

Public Property Timeout As TimeSpan

屬性值

TimeSpan

要求逾時前等候的時間長度。

例外狀況

ArgumentOutOfRangeException

指定的逾時值小於或等於零，而且不是 InfiniteTimeSpan。

InvalidOperationException

作業已經在目前的執行個體上啟動。

ObjectDisposedException

目前的執行個體已經過處置。

範例

下列範例會 Timeout 設定 屬性。

HttpClient httpClient = new HttpClient();
httpClient.Timeout = TimeSpan.FromMinutes(10);

備註

預設值為 100,000 毫秒 (100 秒)。

若要設定無限逾時，請將 屬性值設定為 InfiniteTimeSpan。

功能變數名稱系統 (DNS) 查詢最多可能需要 15 秒才能傳回或逾時。如果您的要求包含需要解析的主機名，而且您設定 Timeout 為小於 15 秒的值，則擲回 之前 WebException 可能需要 15 秒以上，以指出要求的逾時。

相同的逾時會套用至使用此 HttpClient 實例的所有要求。 您也可以針對在工作上使用 CancellationTokenSource 的個別要求設定不同的逾時。 請注意，只會套用兩個逾時的較短時間。