HttpClient.Timeout Eigenschaft

Definition

Namespace:

System.Net.Http

Assembly:

System.Net.Http.dll

Quelle:

HttpClient.cs

Ruft die Zeitspanne ab, nach der das Zeitlimit der Anforderung überschritten ist, oder legt diese fest.

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

Eigenschaftswert

TimeSpan

Die Zeitspanne, nach der das Zeitlimit der Anforderung überschritten ist.

Ausnahmen

ArgumentOutOfRangeException

Der angegebene Timeoutwert ist kleiner oder gleich 0 (null) und nicht InfiniteTimeSpan.

InvalidOperationException

Es wurde bereits ein Vorgang für die aktuelle Instanz gestartet.

ObjectDisposedException

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 fest InfiniteTimeSpan.

Eine DNS-Abfrage (Domain Name System) kann bis zu 15 Sekunden dauern, bis sie zurückgegeben wird oder ein Timeout erfolgt. Wenn Ihre Anforderung einen Hostnamen enthält, der eine Auflösung erfordert und Sie auf einen Wert von weniger als 15 Sekunden festgelegt Timeout haben, kann es 15 Sekunden oder länger dauern, bis ein WebException ausgelöst wird, um ein Timeout für Ihre Anforderung anzugeben.

Das gleiche Timeout gilt für alle Anforderungen, die diese HttpClient instance verwenden. Sie können auch unterschiedliche Timeouts für einzelne Anforderungen festlegen, indem Sie einen CancellationTokenSource für eine Aufgabe verwenden. Beachten Sie, dass nur das kürzere der beiden Timeouts gilt.