Export (0) Print
Expand All

HttpClient.Timeout Property

.NET Framework 4.5

Gets or sets the number of milliseconds to wait before the request times out.

Namespace:  System.Net.Http
Assembly:  System.Net.Http (in System.Net.Http.dll)

public TimeSpan Timeout { get; set; }

Property Value

Type: System.TimeSpan
Returns TimeSpan.
The number of milliseconds to wait before the request times out.

ExceptionCondition
ArgumentOutOfRangeException

The timeout specified is less than or equal to zero and is not Infinite.

InvalidOperationException

An operation has already been started on the current instance.

ObjectDisposedException

The current instance has been disposed.

The default value is 100,000 milliseconds (100 seconds).

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.

The same timeout will apply for all requests using this HttpClient instance. You may also set different timeouts for individual requests using a CancellationTokenSource on a task. Note that only the shorter of the two timeouts will apply.

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5

.NET for Windows Store apps

Supported in: Windows 8

.NET for Windows Phone apps

Supported in: Windows Phone 8.1

Windows Phone 8.1, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft