HttpClient.Timeout Vlastnost

Definice

Obor názvů:

System.Net.Http

Sestavení:

netstandard.dll, System.Net.Http.dll

Zdroj:

HttpClient.cs

Získá nebo nastaví časový rozsah čekání před časovým limitem požadavku.

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

Hodnota vlastnosti

TimeSpan

Časový rozsah, který se má počkat, než vyprší časový limit požadavku.

Výjimky

ArgumentOutOfRangeException

Zadaný časový limit je menší nebo roven nule a není InfiniteTimeSpan

nebo

Zadaný časový limit je větší než MaxValue milisekundy.

InvalidOperationException

Operace již byla spuštěna v aktuální instanci.

ObjectDisposedException

Aktuální instance byla uvolněna.

Příklady

Následující příklad nastaví Timeout vlastnost.

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

Poznámky

Výchozí hodnota je 100 000 milisekund (100 sekund).

Chcete-li nastavit nekonečný časový limit, nastavte hodnotu vlastnosti na InfiniteTimeSpanhodnotu .

Vrácení nebo vypršení časového limitu dotazu DNS (Domain Name System) může trvat až 15 sekund. Pokud váš požadavek obsahuje název hostitele, který vyžaduje překlad, a nastavíte Timeout hodnotu menší než 15 sekund, může trvat 15 sekund nebo déle, než WebException se vyvolá, aby se v požadavku označil časový limit.

Stejný časový limit se použije pro všechny požadavky používající tuto HttpClient instanci. Můžete také nastavit různé časové limity pro jednotlivé požadavky, které používají CancellationTokenSource u úkolu. Mějte na paměti, že platí pouze kratší z těchto dvou časových limitů.