HttpClient.Timeout Propriedade

Definição

Namespace:

System.Net.Http

Assembly:

System.Net.Http.dll

Origem:

HttpClient.cs

Obtém ou define o período de tempo de espera antes que a solicitação expire.

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

Valor da propriedade

TimeSpan

O período de tempo de espera antes que a solicitação expire.

Exceções

ArgumentOutOfRangeException

O tempo excedido especificado é menor ou igual a zero e não é InfiniteTimeSpan.

InvalidOperationException

Uma operação de leitura assíncrona já foi iniciada na instância atual.

ObjectDisposedException

A instância atual foi descartada.

Exemplos

O exemplo a seguir define a Timeout propriedade .

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

Comentários

O valor padrão é 100.000 milissegundos (100 segundos).

Para definir um tempo limite infinito, defina o valor da propriedade como InfiniteTimeSpan.

Uma consulta DNS (Sistema de Nomes de Domínio) pode levar até 15 segundos para retornar ou tempo limite. Se sua solicitação contiver um nome de host que exija resolução e você definir Timeout como um valor inferior a 15 segundos, poderá levar 15 segundos ou mais até que um WebException seja lançado para indicar um tempo limite em sua solicitação.

O mesmo tempo limite será aplicado a todas as solicitações que usam essa HttpClient instância. Você também pode definir tempos limite diferentes para solicitações individuais usando um CancellationTokenSource em uma tarefa. Observe que apenas o menor dos dois tempos limite será aplicado.