HttpClient.Timeout 속성


요청 시간 제한 범위 내에서 대기할 기간을 가져오거나 설정합니다.Gets or sets the timespan to wait before the request times out.

 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

속성 값


요청 시간 제한 범위 내에서 대기할 기간입니다.The timespan to wait before the request times out.


지정한 제한 시간이 0보다 작거나 같고 InfiniteTimeSpan이 아닌 경우The timeout specified is less than or equal to zero and is not InfiniteTimeSpan.

작업이 이미 현재 인스턴스에서 시작된 경우An operation has already been started on the current instance.

현재 인스턴스가 삭제된 경우The current instance has been disposed.


다음 예제에서는 Timeout 속성입니다.The following example sets the Timeout property.

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


기본값은 100,000밀리초(100초)입니다.The default value is 100,000 milliseconds (100 seconds).

무한 시간 제한을 설정 하려면 속성 값을로 설정 InfiniteTimeSpan 합니다.To set an infinite timeout, set the property value to InfiniteTimeSpan.

DNS (도메인 이름 시스템) 쿼리를 반환 하거나 시간이 초과 되는 데 최대 15 초까지 걸릴 수 있습니다. 요청에 확인이 필요한 호스트 이름이 포함 되어 있고가 Timeout 15 초 보다 작은 값으로 설정 된 경우 WebException 요청에 대 한 제한 시간을 나타내기 위해이 throw 되기 전에 15 초 이상이 소요 될 수 있습니다.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.

이 인스턴스를 사용 하는 모든 요청에 대해 동일한 시간 제한이 적용 됩니다 HttpClient .The same timeout will apply for all requests using this HttpClient instance. 작업에서를 사용 하 여 개별 요청에 대해 다른 시간 제한을 설정할 수도 있습니다 CancellationTokenSource .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.

적용 대상