WebRequest.Timeout Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia czas (w milisekundach) przed przekroczeniem limitu czasu żądania.
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
Wartość właściwości
Czas ( w milisekundach) do przekroczenia limitu czasu żądania lub wartość Infinite wskazująca, że żądanie nie przekracza limitu czasu. Wartość domyślna jest definiowana przez klasę potomną.
Wyjątki
Każda próba pobrania lub ustawienia właściwości, gdy właściwość nie jest zastępowana w klasie potomnej.
Przykłady
Poniższy przykład ustawia właściwość Timeout na 10000 milisekund. Jeśli okres przekroczenia limitu czasu wygaśnie przed zwróceniem zasobu, zostanie zgłoszony 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()
Uwagi
Ostrożność
WebRequest
, HttpWebRequest
, ServicePoint
i WebClient
są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.
Właściwość Timeout wskazuje czas (w milisekundach) do momentu przekroczenia limitu czasu żądania i wyrzucenia WebException. Właściwość Timeout ma wpływ tylko na żądania synchroniczne wysyłane za pomocą metody GetResponse. Aby upłynął limit czasu żądań asynchronicznych, użyj metody Abort.
Nuta
Klasa WebRequest jest klasą abstract
. Rzeczywiste zachowanie wystąpień WebRequest w czasie wykonywania jest określane przez klasę potomną zwracaną przez metodę WebRequest.Create. Aby uzyskać więcej informacji na temat wartości domyślnych i wyjątków, zobacz dokumentację klas potomnych, takich jak HttpWebRequest i FileWebRequest.
Uwagi dotyczące dziedziczenia
Klasy potomne sygnalizuje przekroczenie limitu czasu, zgłaszając WebException przy użyciu pola Status ustawionego na wartość Timeout. Gdy Timeout jest ustawiona na wartość Infinite klasa potomna nie przekracza limitu czasu.