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

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