HttpWebRequest.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.
Dient zum Abrufen oder Festlegen des Timeoutwerts in Millisekunden für die GetResponse() und GetRequestStream() Methoden.
public:
virtual property int Timeout { int get(); void set(int value); };public override int Timeout { get; set; }member this.Timeout : int with get, setPublic Overrides Property Timeout As IntegerEigenschaftswert
Die Anzahl der Millisekunden, die gewartet werden sollen, bevor das Anforderungs-Zeitüberschreitungsüberschreitung erfolgt. Der Standardwert ist 100.000 Millisekunden (100 Sekunden).
Ausnahmen
Der angegebene Wert ist kleiner als Null und nicht Infinite.
Beispiele
Im folgenden Codebeispiel wird die Timeout Eigenschaft des HttpWebRequest Objekts festgelegt.
// Create a new 'HttpWebRequest' Object to the mentioned URL.
HttpWebRequest myHttpWebRequest=(HttpWebRequest)WebRequest.Create("http://www.contoso.com");
Console.WriteLine("\nThe timeout time of the request before setting the property is {0} milliSeconds.",myHttpWebRequest.Timeout);
// Set the 'Timeout' property of the HttpWebRequest to 10 milliseconds.
myHttpWebRequest.Timeout=10;
// Display the 'Timeout' property of the 'HttpWebRequest' on the console.
Console.WriteLine("\nThe timeout time of the request after setting the timeout is {0} milliSeconds.",myHttpWebRequest.Timeout);
// A HttpWebResponse object is created and is GetResponse Property of the HttpWebRequest associated with it
HttpWebResponse myHttpWebResponse=(HttpWebResponse)myHttpWebRequest.GetResponse();
' Create a new 'HttpWebRequest' Object to the mentioned URL.
Dim myHttpWebRequest As HttpWebRequest = CType(WebRequest.Create("http://www.contoso.com"), HttpWebRequest)
Console.WriteLine(ControlChars.Cr + "The timeout time of the request before setting the property is {0} milliSeconds", myHttpWebRequest.Timeout)
' Set the 'Timeout' property of the HttpWebRequest to 10 milliseconds.
myHttpWebRequest.Timeout = 10
' Display the 'Timeout' property of the 'HttpWebRequest' on the console.
Console.WriteLine(ControlChars.Cr + "The timeout time of the request after setting the timeout is {0} milliSeconds", myHttpWebRequest.Timeout)
' A HttpWebResponse object is created and is GetResponse Property of the HttpWebRequest associated with it
Dim myHttpWebResponse As HttpWebResponse = CType(myHttpWebRequest.GetResponse(), HttpWebResponse)
Hinweise
Vorsicht
WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.
Timeout ist die Anzahl von Millisekunden, die eine nachfolgende synchrone Anforderung mit der GetResponse Methode auf eine Antwort wartet, und die GetRequestStream Methode wartet auf einen Datenstrom. Dies Timeout gilt für die gesamte Anforderung und Antwort, nicht einzeln für die Aufrufe und GetRequestStreamGetResponse Methoden. Wenn die Ressource nicht innerhalb des Timeoutzeitraums zurückgegeben wird, löst die Anforderung eine WebException mit der Status Eigenschaft festgelegte WebExceptionStatus.Timeout.
Die Timeout Eigenschaft muss festgelegt werden, bevor die GetRequestStream Methode GetResponse aufgerufen wird. Das Ändern der Eigenschaft nach dem Aufrufen der TimeoutGetRequestStream Eigenschaft oder GetResponse Methode hat keine Auswirkung.
Die Timeout Eigenschaft hat keine Auswirkungen auf asynchrone Anforderungen, die mit der Methode oder BeginGetRequestStream der BeginGetResponse Methode vorgenommen wurden.
Vorsicht
Bei asynchronen Anforderungen implementiert die Clientanwendung einen eigenen Timeoutmechanismus. Verweisen Sie auf das Beispiel in der BeginGetResponse Methode.
Verwenden Sie die ReadWriteTimeout Eigenschaft, um anzugeben, wie lange gewartet werden soll, bevor ein Lese- oder Schreibvorgang ausläuft.
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.
