WebRequest.Timeout Eigenschaft

Definition

Ruft die Zeitspanne in Millisekunden bis zum Überschreiten des Zeitlimits der Anforderung ab.Gets or sets the length of time, in milliseconds, before the request times out.

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

Der Zeitraum bis zum Timeout der Anforderung in Millisekunden oder der Wert Infinite, der angibt, dass für die Anforderung kein Timeout festgelegt wurde. Der Standardwert wird von der Nachfolgerklasse definiert.The length of time, in milliseconds, until the request times out, or the value Infinite to indicate that the request does not time out. The default value is defined by the descendant class.

Ausnahmen

Es wurde versucht, die Eigenschaft abzurufen oder festzulegen, obwohl die Eigenschaft in einer Nachfolgerklasse nicht überschrieben wurde.Any attempt is made to get or set the property, when the property is not overridden in a descendant class.

Beispiele

Im folgenden Beispiel wird die Timeout -Eigenschaft auf 10000 Millisekunden festgelegt.The following example sets the Timeout property to 10000 milliseconds. Wenn das Timeout abläuft, bevor die Ressource zurückgegeben werden kann, WebException wird eine ausgelöst.If the timeout period expires before the resource can be returned, a WebException is thrown.

// 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

Die Timeout -Eigenschaft gibt die Zeitdauer in Millisekunden bis zum Timeout der Anforderung an und löst eine WebExceptionaus.The Timeout property indicates the length of time, in milliseconds, until the request times out and throws a WebException. Die Timeout Eigenschaft wirkt sich nur auf synchrone Anforderungen GetResponse aus, die mit der-MethodeThe Timeout property affects only synchronous requests made with the GetResponse method. Verwenden Sie die Abort -Methode, um asynchrone Anforderungen zu Timeout.To time out asynchronous requests, use the Abort method.

Hinweis

Die WebRequest -Klasse ist abstract eine-Klasse.The WebRequest class is an abstract class. Das tatsächliche Verhalten von WebRequest -Instanzen zur Laufzeit wird von der Nachfolger Klasse bestimmt, die von WebRequest.Create der-Methode zurückgegeben wird.The actual behavior of WebRequest instances at run time is determined by the descendant class returned by the WebRequest.Create method. Weitere Informationen zu Standardwerten und Ausnahmen finden Sie in HttpWebRequest der Dokumentation zu den Nachfolger Klassen, z. b. und. FileWebRequestFor more information about default values and exceptions, see the documentation for the descendant classes, such as HttpWebRequest and FileWebRequest.

Hinweise für Vererber

Nachfolger Klassen signalisieren ein Timeout, indem ein WebException -Wert Status mit dem- TimeoutFeld ausgelöst wird.Descendant classes signal a timeout by throwing a WebException with the Status field set to Timeout. Wenn Timeout auf die Nachfolger Infinite Klasse festgelegt ist, tritt kein Timeout auf.When Timeout is set to Infinite the descendant class does not time out.

Gilt für:

Siehe auch