WebRequest.Timeout Свойство

Определение

Возвращает или задает промежуток времени в миллисекундах до истечения срока действия запроса.Gets or sets the length of time, in milliseconds, before the request times out.

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

Значение свойства

Продолжительность времени в миллисекундах до истечения времени ожидания запроса или значение Infinite, указывающее, что время ожидания запроса не истекло. Значение по умолчанию определяется классом Descendants.The length of time, in milliseconds, until the request times out, or the value Infinite to indicate that the request does not time out. The default value is defined by the descendant class.

Исключения

Если свойство не переопределено во вложенном классе, предпринимаются все возможные попытки вернуть или задать его.Any attempt is made to get or set the property, when the property is not overridden in a descendant class.

Примеры

В следующем примере свойству Timeout присваивается значение 10000 миллисекунд.The following example sets the Timeout property to 10000 milliseconds. Если время ожидания истекает до того, как ресурс может быть возвращен, выдается WebException.If the timeout period expires before the resource can be returned, a WebException is thrown.

// 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()

Комментарии

Свойство Timeout указывает продолжительность времени в миллисекундах до истечения времени ожидания запроса и создает исключение WebException.The Timeout property indicates the length of time, in milliseconds, until the request times out and throws a WebException. Свойство Timeout влияет только на синхронные запросы, выполняемые с помощью метода GetResponse.The Timeout property affects only synchronous requests made with the GetResponse method. Чтобы истечение времени ожидания асинхронных запросов, используйте метод Abort.To time out asynchronous requests, use the Abort method.

Примечание

Класс WebRequest является abstractным классом.The WebRequest class is an abstract class. Фактическое поведение WebRequest экземпляров во время выполнения определяется классом-наследником, возвращенным методом WebRequest.Create.The actual behavior of WebRequest instances at run time is determined by the descendant class returned by the WebRequest.Create method. Дополнительные сведения о значениях по умолчанию и исключениях см. в документации по классам-наследникам, таким как HttpWebRequest и FileWebRequest.For more information about default values and exceptions, see the documentation for the descendant classes, such as HttpWebRequest and FileWebRequest.

Примечания для тех, кто наследует этот метод

Классы-потомки сообщают о времени ожидания, вызывая WebException с полем Status, для которого задано значение Timeout.Descendant classes signal a timeout by throwing a WebException with the Status field set to Timeout. Если для параметра Timeout задано значение Infinite дочерний класс не имеет тайм-аута.When Timeout is set to Infinite the descendant class does not time out.

Применяется к

Дополнительно