WebRequest.Timeout Propriedade

Definição

Namespace:

System.Net

Assemblies:

netstandard.dll, System.Net.Requests.dll

Origem:

WebRequest.cs

Obtém ou define o período de tempo, em milissegundos, antes do tempo limite da solicitação.

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

Valor da propriedade

Int32

O período de tempo, em milissegundos, até a solicitação atingir o tempo limite ou o valor Infinite para indicar que a solicitação não atinge o tempo limite. O valor padrão é definido pela classe descendente.

Exceções

NotImplementedException

Qualquer tentativa é feita para obter ou definir a propriedade, quando a propriedade não é substituída em uma classe descendente.

Exemplos

O exemplo a seguir define a Timeout propriedade como 10000 milissegundos. Se o período de tempo limite expirar antes que o recurso possa ser retornado, um WebException será gerado.

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

Comentários

Cuidado

WebRequest, HttpWebRequeste ServicePointWebClient são obsoletos e você não deve usá-los para um novo desenvolvimento. Use HttpClient em seu lugar.

A Timeout propriedade indica o tempo, em milissegundos, até a solicitação atingir o tempo limite e gerar um WebException. A Timeout propriedade afeta somente solicitações síncronas feitas com o GetResponse método. Para cronometrar solicitações assíncronas, use o Abort método.

Nota

A WebRequest classe é uma abstract classe. O comportamento real das instâncias em tempo de WebRequest execução é determinado pela classe descendente retornada pelo WebRequest.Create método. Para obter mais informações sobre valores e exceções padrão, consulte a documentação das classes descendentes, como HttpWebRequest e FileWebRequest.

Notas aos Herdeiros

Classes descendentes sinalizam um tempo limite lançando um WebException com o Status campo definido como Timeout. Quando Timeout é definido como a Infinite classe descendente não faz tempo limite.

Confira também

• Timeout