HttpWebRequest.Timeout-Eigenschaft

Ruft den Timeoutwert für die GetResponse-Methode und die GetRequestStream-Methode ab oder legt diesen fest.

Namespace: System.Net
Assembly: System (in system.dll)

Syntax

'Declaration
Public Overrides Property Timeout As Integer
'Usage
Dim instance As HttpWebRequest
Dim value As Integer

value = instance.Timeout

instance.Timeout = value

public override int Timeout { get; set; }

public:
virtual property int Timeout {
    int get () override;
    void set (int value) override;
}

/** @property */
public int get_Timeout ()

/** @property */
public void set_Timeout (int value)

public override function get Timeout () : int

public override function set Timeout (value : int)

Eigenschaftenwert

Die Wartezeit in Millisekunden bis zum Timeout der Anforderung. Der Standardwert ist 100.000 Millisekunden (100 Sekunden).

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentOutOfRangeException	Der angegebene Wert ist kleiner als 0 (null) und nicht Infinite.

Hinweise

Timeout ist die Anzahl der Millisekunden, die eine mit der GetResponse-Methode ausgeführte nachfolgende synchrone Anforderung auf eine Antwort wartet und die die GetRequestStream-Methode auf einen Stream wartet. Wenn die Ressource nicht vor dem Timeout zurückgegeben wird, löst die Anforderung eine WebException aus, wobei die Status-Eigenschaft auf WebExceptionStatus.Timeout festgelegt ist.

Die Timeout-Eigenschaft hat keine Auswirkungen auf asynchrone Anforderungen, die mit der BeginGetResponse-Methode oder der BeginGetRequestStream-Methode ausgeführt werden.

Warnung

Bei asynchronen Anforderungen implementiert die Clientanwendung einen eigenen Timeoutmechanismus. Weitere Informationen finden Sie im Beispiel für die BeginGetResponse-Methode.

Um die Zeitspanne bis zum Timeout eines Lese- oder Schreibvorgangs anzugeben, verwenden Sie die ReadWriteTimeout-Eigenschaft.

Eine DNS (Domain Name System)-Abfrage kann bis zu 15 Sekunden für den Abschluss oder bis zum Timeout benötigen. Wenn die Anforderung einen Hostnamen enthält, der aufgelöst werden muss, und Sie Timeout auf einen Wert unter 15 Sekunden festlegen, können bis zum Auslösen einer WebException zum Angeben eines Timeouts für die Anforderung 15 Sekunden oder eine noch längere Zeitspanne verstreichen.

Beispiel

Im folgenden Codebeispiel wird die Timeout-Eigenschaft des HttpWebRequest-Objekts festgelegt.

' Create a new 'HttpWebRequest' Object to the mentioned URL.
     Dim myHttpWebRequest As HttpWebRequest = CType(WebRequest.Create("https://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)

// Create a new 'HttpWebRequest' Object to the mentioned URL.
HttpWebRequest myHttpWebRequest=(HttpWebRequest)WebRequest.Create("https://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( "https://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("https://www.contoso.com");
Console.WriteLine("\nThe timeout time of the request before"
    + " setting the property is  {0}  milliSeconds.", 
    System.Convert.ToString(myHttpWebRequest.get_Timeout()));

// Set the  'Timeout' property of the HttpWebRequest to 10 milli 
// seconds.
myHttpWebRequest.set_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.", 
    System.Convert.ToString(myHttpWebRequest.get_Timeout()));
// A HttpWebResponse object is created and is GetResponse Property 
//of the HttpWebRequest associated with it 
HttpWebResponse myHttpWebResponse = (HttpWebResponse)
    myHttpWebRequest.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

HttpWebRequest-Klasse
HttpWebRequest-Member
System.Net-Namespace
HttpWebRequest.ReadWriteTimeout-Eigenschaft