HttpClient.Timeout 屬性

定義

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

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

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

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

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

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

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

下列範例會 Timeout 設定屬性。

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

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

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

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

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