WebRequest.Timeout Właściwość

Definicja

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, ServicePointi 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.

Dotyczy

Zobacz też