WebRequest.Timeout Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá nebo nastaví dobu v milisekundách před vypršením časového limitu požadavku.
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
Hodnota vlastnosti
Doba v milisekundách, do vypršení časového limitu požadavku nebo hodnota Infinite označující, že požadavek nevysadí časový limit. Výchozí hodnota je definována potomkem třídy.
Výjimky
Jakýkoli pokus o získání nebo nastavení vlastnosti, pokud vlastnost není přepsána v potomk třídy.
Příklady
Následující příklad nastaví Timeout vlastnost na 10000 milisekund. Pokud vyprší časový limit před vrácením prostředku, vyvolá se WebException.
// 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()
Poznámky
Opatrnost
WebRequest
, HttpWebRequest
, ServicePoint
a WebClient
jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.
Vlastnost Timeout označuje dobu v milisekundách, dokud nevyvolá časový limit požadavku a nevyvolá WebException. Vlastnost Timeout ovlivňuje pouze synchronní požadavky provedené pomocí metody GetResponse. K vypršení časového limitu asynchronních požadavků použijte metodu Abort.
Poznámka
Třída WebRequest je třída abstract
. Skutečné chování WebRequest instancí za běhu je určeno následnou třídou vrácenou metodou WebRequest.Create. Další informace o výchozích hodnotách a výjimkách naleznete v dokumentaci pro potomky třídy, jako jsou HttpWebRequest a FileWebRequest.
Poznámky pro dědice
Třídy potomků signalizují časový limit vyvoláním WebException s polem Status nastaveným na Timeout. Pokud je Timeout nastavena na Infinite potomk třída nevysadí časový limit.