HttpClient.Timeout 屬性

定義

命名空間:

System.Net.Http

組件:

System.Net.Http.dll

它會設定等待時間跨度，直到請求逾時。

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

-或-

指定的逾時時間大於 MaxValue 毫秒。

InvalidOperationException

目前的實例已經開始了操作。

ObjectDisposedException

目前的實例已被處理。

範例

以下範例設定了屬性 Timeout 。

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

備註

預設值為 100,000 毫秒（100 秒）。

要設定無限超時，將屬性值設為 InfiniteTimeSpan。

網域名稱系統（DNS）查詢可能需長達15秒才能返回或逾時。如果你的請求包含需要解決的主機名稱，且你設定 Timeout 的值少於 15 秒，可能需要 15 秒或更久才會拋出 a WebException 表示請求暫停。

使用此 HttpClient 實例的所有請求都會適用相同的逾時。 你也可以在任務上為 CancellationTokenSource 個別請求設定不同的逾時時間。 請注意，只有較短的那個暫停會適用。