WebRequest.Timeout-Eigenschaft
Ruft den Zeitraum ab, an dem das Zeitlimit der Anforderung überschritten ist, oder legt diesen fest.
Namespace: System.Net
Assembly: System (in system.dll)
Syntax
'Declaration
Public Overridable Property Timeout As Integer
'Usage
Dim instance As WebRequest
Dim value As Integer
value = instance.Timeout
instance.Timeout = value
public virtual int Timeout { get; set; }
public:
virtual property int Timeout {
int get ();
void set (int value);
}
/** @property */
public int get_Timeout ()
/** @property */
public void set_Timeout (int value)
public function get Timeout () : int
public function set Timeout (value : int)
Eigenschaftenwert
Der Zeitraum bis zum Timeout der Anforderung in Millisekunden oder der Wert Timeout.Infinite, der angibt, dass für die Anforderung kein Timeout festgelegt wurde. Der Standardwert wird von der abgeleiteten Klasse definiert.
Ausnahmen
Ausnahmetyp | Bedingung |
---|---|
Es wurde versucht, die Eigenschaft abzurufen oder festzulegen, obwohl die Eigenschaft in einer abgeleiteten Klasse nicht überschrieben wurde. |
Hinweise
Die Timeout-Eigenschaft gibt den Zeitraum in Millisekunden an, nach dem das Timeout der Anforderung überschritten ist, und löst eine WebException aus. Die Timeout-Eigenschaft wirkt sich lediglich auf synchrone, mit der GetResponse-Methode durchgeführte Anforderungen aus. Verwenden Sie für Timeouts asynchroner Anforderungen die Abort-Methode.
Hinweis
Die WebRequest-Klasse ist eine abstract Klasse. Das tatsächliche Verhalten von WebRequest-Instanzen zur Laufzeit wird von der abgeleiteten Klasse bestimmt, die von der System.Net.WebRequest.Create-Methode zurückgegeben wird. Weitere Informationen über Standardwerte und Ausnahmen finden Sie in der Dokumentation zu den abgeleiteten Klassen, z. B. HttpWebRequest und FileWebRequest.
Hinweise für Erben Abgeleitete Klassen signalisieren ein Timeout durch Auslösen einer WebException, wobei das Status-Feld auf WebExceptionStatus.Timeout festgelegt ist. Wenn Timeout auf Timeout.Infinite festgelegt ist, liegt für die abgeleitete Klasse kein Timeout vor.
Beispiel
Im folgenden Beispiel wird die Timeout-Eigenschaft auf 10000 Millisekunden festgelegt. Wenn das Timeout abläuft, bevor die Ressource zurückgegeben werden kann, wird eine WebException ausgelöst.
' Create a new WebRequest Object to the mentioned URL.
Dim myWebRequest As WebRequest = WebRequest.Create("https://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()
// Create a new WebRequest Object to the mentioned URL.
WebRequest myWebRequest=WebRequest.Create("https://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( "https://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("https://www.contoso.com");
Console.WriteLine("\nThe Timeout time of the request before "
+ "setting is : {0} milliseconds", System.Convert.ToString(
myWebRequest.get_Timeout()));
// Set the 'Timeout' property in Milliseconds.
myWebRequest.set_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();
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0
Siehe auch
Referenz
WebRequest-Klasse
WebRequest-Member
System.Net-Namespace
HttpWebRequest.Timeout-Eigenschaft