WebRequest.Timeout Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit la durée, en millisecondes, avant l’expiration de la requête.
public:
virtual property int Timeout { int get(); void set(int value); };public virtual int Timeout { get; set; }member this.Timeout : int with get, setPublic Overridable Property Timeout As IntegerValeur de propriété
Durée, en millisecondes, jusqu’à ce que la demande expire, ou la valeur Infinite pour indiquer que la requête n’expire pas. La valeur par défaut est définie par la classe descendante.
Exceptions
Toute tentative est effectuée pour obtenir ou définir la propriété, lorsque la propriété n’est pas remplacée dans une classe descendante.
Exemples
L’exemple suivant définit la propriété Timeout sur 1 0000 millisecondes. Si la période d’expiration expire avant que la ressource ne puisse être retournée, une WebException est levée.
// 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()
Remarques
Prudence
WebRequest, HttpWebRequest, ServicePointet WebClient sont obsolètes et vous ne devez pas les utiliser pour le nouveau développement. Utilisez HttpClient à la place.
La propriété Timeout indique la durée, en millisecondes, jusqu’à ce que la requête expire et lève une WebException. La propriété Timeout affecte uniquement les requêtes synchrones effectuées avec la méthode GetResponse. Pour expirer les requêtes asynchrones, utilisez la méthode Abort.
Note
La classe WebRequest est une classe abstract. Le comportement réel des instances de WebRequest au moment de l’exécution est déterminé par la classe descendante retournée par la méthode WebRequest.Create. Pour plus d’informations sur les valeurs et exceptions par défaut, consultez la documentation relative aux classes descendantes, telles que HttpWebRequest et FileWebRequest.
Notes pour les héritiers
Les classes descendantes signalent un délai d’expiration en lisant un WebException avec le champ Status défini sur Timeout. Lorsque Timeout est défini sur Infinite la classe descendante n’expire pas.
