HttpClient.Timeout Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft den Zeitbereich ab, der gewartet werden soll, bevor die Anforderung ausgeht, oder legt diesen fest.
public:
property TimeSpan Timeout { TimeSpan get(); void set(TimeSpan value); };public TimeSpan Timeout { get; set; }member this.Timeout : TimeSpan with get, setPublic Property Timeout As TimeSpanEigenschaftswert
Der Zeitbereich, der gewartet werden soll, bevor das Anforderungs-Zeitüberschreitungsüberschreitung erfolgt.
Ausnahmen
Das angegebene Timeout ist kleiner oder gleich Null und ist nicht InfiniteTimeSpan
-oder-
Das angegebene Timeout ist größer als MaxValue Millisekunden.
Für die aktuelle Instanz wurde bereits ein Vorgang gestartet.
Die aktuelle Instanz wurde verworfen.
Beispiele
Im folgenden Beispiel wird die Timeout Eigenschaft festgelegt.
HttpClient httpClient = new HttpClient();
httpClient.Timeout = TimeSpan.FromMinutes(10);
Hinweise
Der Standardwert ist 100.000 Millisekunden (100 Sekunden).
Um ein unendliches Timeout festzulegen, legen Sie den Eigenschaftswert auf InfiniteTimeSpan.
Eine DNS-Abfrage (Domain Name System) kann bis zu 15 Sekunden dauern, bis ein Timeout zurückgegeben oder beendet wird. Wenn Ihre Anforderung einen Hostnamen enthält, der eine Auflösung erfordert und Sie auf einen Wert kleiner als 15 Sekunden festlegen Timeout , kann es 15 Sekunden oder mehr dauern, bis ein WebException Timeout für Ihre Anforderung angegeben wird.
Das gleiche Timeout gilt für alle Anforderungen, die diese HttpClient Instanz verwenden. Sie können auch unterschiedliche Timeouts für einzelne Anforderungen festlegen, indem Sie eine CancellationTokenSource Aufgabe verwenden. Beachten Sie, dass nur die kürzeren beiden Timeouts angewendet werden.