HttpWebRequest.Timeout HttpWebRequest.Timeout HttpWebRequest.Timeout HttpWebRequest.Timeout Property

Definition

Ruft den Timeoutwert in Millisekunden für die GetResponse()-Methode und die GetRequestStream()-Methode ab oder legt diesen fest.Gets or sets the time-out value in milliseconds for the GetResponse() and GetRequestStream() methods.

public:
 virtual property int Timeout { int get(); void set(int value); };
public override int Timeout { get; set; }
member this.Timeout : int with get, set
Public Overrides Property Timeout As Integer

Eigenschaftswert

Die Wartezeit in Millisekunden bis zum Timeout der Anforderung. Der Standardwert ist 100.000 Millisekunden (100 Sekunden).The number of milliseconds to wait before the request times out. The default value is 100,000 milliseconds (100 seconds).

Ausnahmen

Der angegebene Wert ist kleiner als 0 (null) und nicht Infinite.The value specified is less than zero and is not Infinite.

Beispiele

Im folgenden Codebeispiel wird die Timeout Eigenschaft der HttpWebRequest Objekt.The following code example sets the Timeout property of the HttpWebRequest object.

// 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, der bei eine nachfolgende synchrone Anforderung erstellt die GetResponse Methode, die für eine Antwort wartet und die GetRequestStream Methode wartet für einen Stream.Timeout is the number of milliseconds that a subsequent synchronous request made with the GetResponse method waits for a response, and the GetRequestStream method waits for a stream. Die Timeout gilt auf die gesamte Anforderung und Antwort nicht einzeln für die GetRequestStream und GetResponse Methodenaufrufe.The Timeout applies to the entire request and response, not individually to the GetRequestStream and GetResponse method calls. Wenn die Ressource innerhalb des Timeoutzeitraums nicht zurückgegeben wird, löst die Anforderung einer WebException mit der Status -Eigenschaftensatz auf WebExceptionStatus.Timeout.If the resource is not returned within the time-out period, the request throws a WebException with the Status property set to WebExceptionStatus.Timeout.

Die Timeout Eigenschaft muss festgelegt werden, bevor die GetRequestStream oder GetResponse Methode wird aufgerufen.The Timeout property must be set before the GetRequestStream or GetResponse method is called. Ändern der Timeout Eigenschaft nach dem Aufruf der GetRequestStream oder GetResponse Methode hat keine AuswirkungChanging the Timeout property after calling the GetRequestStream or GetResponse method has no effect

Die Timeout Eigenschaft hat keine Auswirkungen auf die asynchrone Anforderungen, die durch die BeginGetResponse oder BeginGetRequestStream Methode.The Timeout property has no effect on asynchronous requests made with the BeginGetResponse or BeginGetRequestStream method.

Achtung

Im Fall von asynchronen Anforderungen auf wird die Clientanwendung einen eigenen Timeoutmechanismus implementiert.In the case of asynchronous requests, the client application implements its own time-out mechanism. Finden Sie im Beispiel in der BeginGetResponse Methode.Refer to the example in the BeginGetResponse method.

Verwenden Sie zum Angeben der Zeitspanne bis zum Lesen oder Schreiben Timeout des Vorgangs die ReadWriteTimeout Eigenschaft.To specify the amount of time to wait before a read or write operation times out, use the ReadWriteTimeout property.

Eine Domain Name System (DNS)-Abfrage dauert bis zu 15 Sekunden oder das Timeout an. Wenn Ihre Anforderung enthält einen Hostnamen an, die Lösung erforderlich sind, und legen Sie Sie Timeout auf einen Wert kleiner als 15 Sekunden dauert möglicherweise 15 Sekunden oder mehr vor einer WebException wird ausgelöst, um ein Timeout bei der Anforderung angeben.A Domain Name System (DNS) query may take up to 15 seconds to return or time out. If your request contains a host name that requires resolution and you set Timeout to a value less than 15 seconds, it may take 15 seconds or more before a WebException is thrown to indicate a timeout on your request.

Gilt für:

Siehe auch