HttpWebRequest.Timeout HttpWebRequest.Timeout HttpWebRequest.Timeout HttpWebRequest.Timeout Property

Definición

Obtiene o establece el valor de tiempo de espera, en milisegundos, para los métodos GetResponse() y GetRequestStream().Gets or sets the time-out value in milliseconds for the GetResponse() and GetRequestStream() methods.

public:
 virtual property int Timeout { int get(); void set(int value); };
public override int Timeout { get; set; }
member this.Timeout : int with get, set
Public Overrides Property Timeout As Integer

Valor de propiedad

Número de milisegundos que se va a esperar antes de que se agote el tiempo de espera de la solicitud. El valor predeterminado es 100.000 milisegundos (100 segundos).The number of milliseconds to wait before the request times out. The default value is 100,000 milliseconds (100 seconds).

Excepciones

El valor especificado es menor que cero y no es Infinite.The value specified is less than zero and is not Infinite.

Ejemplos

En el ejemplo HttpWebRequest de código siguiente Timeout se establece la propiedad del objeto.The following code example sets the Timeout property of the HttpWebRequest object.

// Create a new 'HttpWebRequest' Object to the mentioned URL.
HttpWebRequest^ myHttpWebRequest = (HttpWebRequest^)( WebRequest::Create( "http://www.contoso.com" ) );
Console::WriteLine( "\nThe timeout time of the request before setting the property is {0} milliseconds.", myHttpWebRequest->Timeout );
// Set the  'Timeout' property of the HttpWebRequest to 10 milliseconds.
myHttpWebRequest->Timeout = 10;
// Display the 'Timeout' property of the 'HttpWebRequest' on the console.
Console::WriteLine( "\nThe timeout time of the request after setting the timeout is {0} milliseconds.", myHttpWebRequest->Timeout );
// A HttpWebResponse object is created and is GetResponse Property of the HttpWebRequest associated with it
HttpWebResponse^ myHttpWebResponse = (HttpWebResponse^)( myHttpWebRequest->GetResponse() );
// Create a new 'HttpWebRequest' Object to the mentioned URL.
HttpWebRequest myHttpWebRequest=(HttpWebRequest)WebRequest.Create("http://www.contoso.com");
Console.WriteLine("\nThe timeout time of the request before setting the property is  {0}  milliSeconds.",myHttpWebRequest.Timeout);
// Set the  'Timeout' property of the HttpWebRequest to 10 milliseconds.
myHttpWebRequest.Timeout=10;
// Display the 'Timeout' property of the 'HttpWebRequest' on the console.
Console.WriteLine("\nThe timeout time of the request after setting the timeout is {0}  milliSeconds.",myHttpWebRequest.Timeout);
// A HttpWebResponse object is created and is GetResponse Property of the HttpWebRequest associated with it 
HttpWebResponse myHttpWebResponse=(HttpWebResponse)myHttpWebRequest.GetResponse();
' Create a new 'HttpWebRequest' Object to the mentioned URL.
     Dim myHttpWebRequest As HttpWebRequest = CType(WebRequest.Create("http://www.contoso.com"), HttpWebRequest)
     Console.WriteLine(ControlChars.Cr + "The timeout time of the request before setting the property is  {0}  milliSeconds", myHttpWebRequest.Timeout)
    ' Set the  'Timeout' property of the HttpWebRequest to 10 milliseconds.
 myHttpWebRequest.Timeout = 10	
     ' Display the 'Timeout' property of the 'HttpWebRequest' on the console.
     Console.WriteLine(ControlChars.Cr + "The timeout time of the request after setting the timeout is {0}  milliSeconds", myHttpWebRequest.Timeout)
     ' A HttpWebResponse object is created and is GetResponse Property of the HttpWebRequest associated with it 
     Dim myHttpWebResponse As HttpWebResponse = CType(myHttpWebRequest.GetResponse(), HttpWebResponse)

Comentarios

Timeoutes el número de milisegundos que una solicitud sincrónica subsiguiente realizada con el GetResponse método espera una respuesta y el GetRequestStream método espera un flujo.Timeout is the number of milliseconds that a subsequent synchronous request made with the GetResponse method waits for a response, and the GetRequestStream method waits for a stream. Se aplica a toda la solicitud y respuesta, no individualmente a las GetRequestStream llamadas al método y GetResponse. TimeoutThe Timeout applies to the entire request and response, not individually to the GetRequestStream and GetResponse method calls. Si el recurso no se devuelve dentro del período de tiempo de espera, la solicitud inicia una WebException con la Status propiedad establecida en WebExceptionStatus.Timeout.If the resource is not returned within the time-out period, the request throws a WebException with the Status property set to WebExceptionStatus.Timeout.

La Timeout propiedad se debe establecer antes de GetRequestStream llamar GetResponse al método o.The Timeout property must be set before the GetRequestStream or GetResponse method is called. Cambiar la Timeout propiedad después de llamar GetRequestStream al GetResponse método o no tiene ningún efectoChanging the Timeout property after calling the GetRequestStream or GetResponse method has no effect

La Timeout propiedad no tiene ningún efecto en las solicitudes asincrónicas realizadas BeginGetResponse con BeginGetRequestStream el método o.The Timeout property has no effect on asynchronous requests made with the BeginGetResponse or BeginGetRequestStream method.

Precaución

En el caso de las solicitudes asincrónicas, la aplicación cliente implementa su propio mecanismo de tiempo de espera.In the case of asynchronous requests, the client application implements its own time-out mechanism. Consulte el ejemplo en el BeginGetResponse método.Refer to the example in the BeginGetResponse method.

Para especificar la cantidad de tiempo que hay que esperar antes de que se agote el tiempo de espera ReadWriteTimeout de una operación de lectura o escritura, utilice la propiedad.To specify the amount of time to wait before a read or write operation times out, use the ReadWriteTimeout property.

Una consulta de sistema de nombres de dominio (DNS) puede tardar hasta 15 segundos en devolverse o agotarse el tiempo de espera. Si la solicitud contiene un nombre de host que requiere resolución y establece Timeout en un valor inferior a 15 segundos, puede tardar 15 segundos o más antes de WebException que se inicie una para indicar un tiempo de espera de la solicitud.A Domain Name System (DNS) query may take up to 15 seconds to return or time out. If your request contains a host name that requires resolution and you set Timeout to a value less than 15 seconds, it may take 15 seconds or more before a WebException is thrown to indicate a timeout on your request.

Se aplica a

Consulte también: