HttpClient.Timeout 属性

定义

获取或设置请求超时前等待的时间跨度。

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 秒的值,则可能需要 15 秒或更多时间才能 WebException 引发 以指示请求超时。

使用此实例的所有请求 HttpClient 都将应用相同的超时。 还可以使用 CancellationTokenSource 任务上的 为单个请求设置不同的超时。 请注意,只有两个超时中较短的将适用。

适用于