HttpClient.Timeout HttpClient.Timeout HttpClient.Timeout HttpClient.Timeout Property

Definição

Obtém ou define o período de tempo de espera antes que a solicitação expire.Gets or sets the timespan to wait before the request times out.

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

O período de tempo de espera antes que a solicitação expire.The timespan to wait before the request times out.

Exceções

O tempo excedido especificado é menor ou igual a zero e não é InfiniteTimeSpan.The timeout specified is less than or equal to zero and is not InfiniteTimeSpan.

Uma operação de leitura assíncrona já foi iniciada na instância atual.An operation has already been started on the current instance.

A instância atual foi descartada.The current instance has been disposed.

Comentários

O valor padrão é 100.000 milissegundos (100 segundos).The default value is 100,000 milliseconds (100 seconds).

Para definir um tempo limite infinito, defina o valor da InfiniteTimeSpanPropriedade como.To set an infinite timeout, set the property value to InfiniteTimeSpan.

Uma consulta DNS (sistema de nomes de domínio) pode levar até 15 segundos para retornar ou atingir o tempo limite. Se sua solicitação contiver um nome de host que requer resolução e Timeout você definir com um valor menor que 15 segundos, pode levar 15 segundos ou mais antes WebException que um seja lançado para indicar um tempo limite em sua solicitação.A Domain Name System (DNS) query may take up to 15 seconds to return or time out. If your request contains a host name that requires resolution and you set Timeout to a value less than 15 seconds, it may take 15 seconds or more before a WebException is thrown to indicate a timeout on your request.

O mesmo tempo limite será aplicado a todas as solicitações HttpClient que usam essa instância.The same timeout will apply for all requests using this HttpClient instance. Você também pode definir tempos limite diferentes para solicitações individuais usando um CancellationTokenSource em uma tarefa.You may also set different timeouts for individual requests using a CancellationTokenSource on a task. Observe que apenas os dois tempos limite serão aplicados.Note that only the shorter of the two timeouts will apply.

ExemploExample

O exemplo a seguir define Timeout a propriedade.The following example sets the Timeout property.

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

Aplica-se a