WebRequest.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 die Zeitdauer in Millisekunden ab, bevor die Anforderung timeout ist, oder legt diese fest.
public:
virtual property int Timeout { int get(); void set(int value); };
public virtual int Timeout { get; set; }
member this.Timeout : int with get, set
Public Overridable Property Timeout As Integer
Eigenschaftswert
Die Zeitdauer in Millisekunden, bis die Anforderung timeout ist, oder der Wert Infinite, um anzugeben, dass die Anforderung kein Timeout ausführt. Der Standardwert wird durch die absteigende Klasse definiert.
Ausnahmen
Es wird versucht, die Eigenschaft abzurufen oder festzulegen, wenn die Eigenschaft nicht in einer untergeordneten Klasse überschrieben wird.
Beispiele
Im folgenden Beispiel wird die eigenschaft Timeout auf 10000 Millisekunden festgelegt. Wenn der Timeoutzeitraum abläuft, bevor die Ressource zurückgegeben werden kann, wird ein WebException ausgelöst.
// Create a new WebRequest Object to the mentioned URL.
WebRequest^ myWebRequest = WebRequest::Create( "http://www.contoso.com" );
Console::WriteLine( "\nThe Timeout time of the request before setting is : {0} milliseconds", myWebRequest->Timeout );
// Set the 'Timeout' property in Milliseconds.
myWebRequest->Timeout = 10000;
// This request will throw a WebException if it reaches the timeout limit
// before it is able to fetch the resource.
WebResponse^ myWebResponse = myWebRequest->GetResponse();
// Create a new WebRequest Object to the mentioned URL.
WebRequest myWebRequest=WebRequest.Create("http://www.contoso.com");
Console.WriteLine("\nThe Timeout time of the request before setting is : {0} milliseconds",myWebRequest.Timeout);
// Set the 'Timeout' property in Milliseconds.
myWebRequest.Timeout=10000;
// This request will throw a WebException if it reaches the timeout limit before it is able to fetch the resource.
WebResponse myWebResponse=myWebRequest.GetResponse();
' Create a new WebRequest Object to the mentioned URL.
Dim myWebRequest As WebRequest = WebRequest.Create("http://www.contoso.com")
Console.WriteLine(ControlChars.Cr + "The Timeout time of the request before setting is : {0} milliseconds", myWebRequest.Timeout)
' Set the 'Timeout' property in Milliseconds.
myWebRequest.Timeout = 10000
' Assign the response object of 'WebRequest' to a 'WebResponse' variable.
Dim myWebResponse As WebResponse = myWebRequest.GetResponse()
Hinweise
Vorsicht
WebRequest
, HttpWebRequest
, ServicePoint
und WebClient
sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.
Die Timeout-Eigenschaft gibt die Zeitdauer in Millisekunden an, bis die Anforderung timeout ist und eine WebExceptionauslöst. Die Timeout-Eigenschaft wirkt sich nur auf synchrone Anforderungen aus, die mit der GetResponse-Methode vorgenommen wurden. Verwenden Sie zum Timeout asynchroner Anforderungen die Abort-Methode.
Anmerkung
Die WebRequest Klasse ist eine abstract
Klasse. Das tatsächliche Verhalten von WebRequest Instanzen zur Laufzeit wird durch die von der WebRequest.Create-Methode zurückgegebene absteigende Klasse bestimmt. Weitere Informationen zu Standardwerten und Ausnahmen finden Sie in der Dokumentation für die untergeordneten Klassen, z. B. HttpWebRequest und FileWebRequest.
Hinweise für Vererber
Absteigende Klassen signalisieren ein Timeout, indem ein WebException ausgelöst wird, wobei das feld Status auf Timeoutfestgelegt ist. Wenn Timeout auf Infinite festgelegt ist, wird kein Timeout der absteigenden Klasse ausgeführt.