WebRequest.Timeout Propriedade

Definição

Obtém ou define a duração, em milissegundos, antes que a solicitação atinja o tempo limite.

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

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

Tentativa de obter ou definir a propriedade, quando a propriedade não foi 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.
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

A Timeout propriedade indica o período de tempo, em milissegundos, até que a solicitação exceda e gere um WebException. A Timeout propriedade afeta apenas solicitações síncronas feitas com o GetResponse método . Para atingir o tempo limite de solicitações assíncronas, use o Abort método .

Observação

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

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

Aplica-se a

Confira também