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.
Ruft den Timeoutwert in Millisekunden für die GetResponse()-Methode und die GetRequestStream()-Methode ab oder legt diesen fest.
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 warten sollen, bevor die Anforderung zeitüberschreitungen. Der Standardwert ist 100.000 Millisekunden (100 Sekunden).
Ausnahmen
Der angegebene Wert ist kleiner als null (0) und ungleich 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.
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
Timeout ist die Anzahl der 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 GetRequestStream Aufrufe und GetResponse Methodenaufrufe. Wenn die Ressource innerhalb des Timeoutzeitraums nicht zurückgegeben wird, löst die Anforderung eine WebException mit der auf die Status Eigenschaft festgelegte WebExceptionStatus.TimeoutEigenschaft aus.
Die Timeout Eigenschaft muss festgelegt werden, bevor die GetResponse GetRequestStream Methode aufgerufen wird. Das Ändern der Eigenschaft nach dem Aufrufen der Timeout GetRequestStream GetResponse Methode hat keine Auswirkung
Die Timeout Eigenschaft hat keine Auswirkungen auf asynchrone Anforderungen, die mit der BeginGetResponse Oder-Methode BeginGetRequestStream vorgenommen wurden.
Achtung
Bei asynchronen Anforderungen implementiert die Clientanwendung einen eigenen Timeoutmechanismus. Weitere Informationen finden Sie im Beispiel in der BeginGetResponse Methode.
Verwenden Sie die ReadWriteTimeout Eigenschaft, um den Zeitraum anzugeben, der warten soll, bevor ein Lese- oder Schreibvorgang timeout ist.
Eine DNS-Abfrage (Domain Name System) kann bis zu 15 Sekunden dauern, bis sie zurückgegeben oder timeout sind. Wenn Ihre Anforderung einen Hostnamen enthält, der eine Auflösung erfordert und Sie auf einen Wert festgelegt Timeout haben, der kleiner als 15 Sekunden ist, kann es 15 Sekunden oder mehr dauern, bevor ein WebException Timeout für Ihre Anforderung angezeigt wird.