HttpWebRequest.BeginGetResponse(AsyncCallback, Object) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Comienza una solicitud asincrónica a un recurso de Internet.
public:
override IAsyncResult ^ BeginGetResponse(AsyncCallback ^ callback, System::Object ^ state);public override IAsyncResult BeginGetResponse(AsyncCallback callback, object state);public override IAsyncResult BeginGetResponse(AsyncCallback? callback, object? state);override this.BeginGetResponse : AsyncCallback * obj -> IAsyncResultPublic Overrides Function BeginGetResponse (callback As AsyncCallback, state As Object) As IAsyncResultParámetros
- callback
- AsyncCallback
Delegado de AsyncCallback.
- state
- Object
Objeto de estado de esta solicitud.
Devoluciones
Un IAsyncResult que hace referencia a la solicitud asincrónica de una respuesta.
Excepciones
La secuencia ya está en uso por una llamada anterior a BeginGetResponse(AsyncCallback, Object)
-o-
TransferEncoding se establece en un valor y SendChunked se false.
-o-
El grupo de subprocesos se está quedando sin subprocesos.
Method es GET o HEAD, y ContentLength es mayor que cero o SendChunked es true.
-o-
KeepAlive es true, AllowWriteStreamBuffering es falsey ContentLength es -1, SendChunked es false y Method es POST o PUT.
-o-
El HttpWebRequest tiene un cuerpo de entidad, pero se llama al método BeginGetResponse(AsyncCallback, Object) sin llamar al método BeginGetRequestStream(AsyncCallback, Object).
-o-
El ContentLength es mayor que cero, pero la aplicación no escribe todos los datos prometidos.
Abort() se llamó anteriormente.
Ejemplos
En el ejemplo de código siguiente se usa el método BeginGetResponse para realizar una solicitud asincrónica para un recurso de Internet.
Nota
En el caso de las solicitudes asincrónicas, es responsabilidad de la aplicación cliente implementar su propio mecanismo de tiempo de espera. En el ejemplo de código siguiente se muestra cómo hacerlo.
using System;
using System.Net;
using System.IO;
using System.Text;
using System.Threading;
public static class WebRequestAPMSample
{
private const int BufferSize = 1024;
private class RequestState
{
public StringBuilder ResponseBuilder { get; }
public byte[] ReadBuffer { get; }
public WebRequest Request { get; }
public WebResponse Response { get; set; }
public Stream ResponseStream { get; set; }
public RequestState(WebRequest request)
{
ReadBuffer = new byte[BufferSize];
ResponseBuilder = new StringBuilder();
Request = request;
}
public void OnResponseBytesRead(int read) => ResponseBuilder.Append(Encoding.UTF8.GetString(ReadBuffer, 0, read));
}
public static ManualResetEvent allDone = new ManualResetEvent(false);
public static void Main()
{
try
{
// Create a WebRequest object to the desired URL.
WebRequest webRequest = WebRequest.Create("http://www.contoso.com");
webRequest.Timeout = 10_000; // Set 10sec timeout.
// Create an instance of the RequestState and assign the previous myHttpWebRequest
// object to its request field.
RequestState requestState = new RequestState(webRequest);
// Start the asynchronous request.
IAsyncResult result = webRequest.BeginGetResponse(new AsyncCallback(ResponseCallback), requestState);
// Wait for the response or for failure. The processing happens in the callback.
allDone.WaitOne();
// Release the WebResponse resources.
requestState.Response?.Close();
}
catch (WebException e)
{
Console.WriteLine("\nMain(): WebException raised!");
Console.WriteLine("\nMessage:{0}", e.Message);
Console.WriteLine("\nStatus:{0}", e.Status);
Console.WriteLine("Press any key to continue..........");
Console.Read();
}
catch (Exception e)
{
Console.WriteLine("\nMain(): Exception raised!");
Console.WriteLine("Source :{0} ", e.Source);
Console.WriteLine("Message :{0} ", e.Message);
Console.WriteLine("Press any key to continue..........");
Console.Read();
}
}
private static void HandleSyncResponseReadCompletion(IAsyncResult asyncResult)
{
RequestState requestState = (RequestState)asyncResult.AsyncState;
Stream responseStream = requestState.ResponseStream;
bool readComplete = false;
while (asyncResult.CompletedSynchronously && !readComplete)
{
int read = responseStream.EndRead(asyncResult);
if (read > 0)
{
requestState.OnResponseBytesRead(read);
asyncResult = responseStream.BeginRead(requestState.ReadBuffer, 0, BufferSize, new AsyncCallback(ReadCallBack), requestState);
}
else
{
readComplete = true;
HandleReadCompletion(requestState);
}
}
}
private static void ResponseCallback(IAsyncResult asynchronousResult)
{
try
{
// AsyncState is an instance of RequestState.
RequestState requestState = (RequestState)asynchronousResult.AsyncState;
WebRequest request = requestState.Request;
requestState.Response = request.EndGetResponse(asynchronousResult);
// Read the response into a Stream.
Stream responseStream = requestState.Response.GetResponseStream();
requestState.ResponseStream = responseStream;
// Begin the Reading of the contents of the HTML page and print it to the console.
IAsyncResult asynchronousReadResult = responseStream.BeginRead(requestState.ReadBuffer, 0, BufferSize, new AsyncCallback(ReadCallBack), requestState);
HandleSyncResponseReadCompletion(asynchronousReadResult);
}
catch (WebException e)
{
Console.WriteLine("\nRespCallback(): Exception raised!");
Console.WriteLine("\nMessage:{0}", e.Message);
Console.WriteLine("\nStatus:{0}", e.Status);
allDone.Set();
}
}
// Print the webpage to the standard output, close the stream and signal completion.
private static void HandleReadCompletion(RequestState requestState)
{
Console.WriteLine("\nThe contents of the Html page are : ");
if (requestState.ResponseBuilder.Length > 1)
{
string stringContent;
stringContent = requestState.ResponseBuilder.ToString();
Console.WriteLine(stringContent);
}
Console.WriteLine("Press any key to continue..........");
Console.ReadLine();
requestState.ResponseStream.Close();
allDone.Set();
}
private static void ReadCallBack(IAsyncResult asyncResult)
{
if (asyncResult.CompletedSynchronously)
{
// To avoid recursive synchronous calls into ReadCallBack,
// synchronous completion is handled at the BeginRead call-site.
return;
}
try
{
RequestState requestState = (RequestState)asyncResult.AsyncState;
Stream responseStream = requestState.ResponseStream;
int read = responseStream.EndRead(asyncResult);
// Read the HTML page and then print it to the console.
if (read > 0)
{
requestState.OnResponseBytesRead(read);
IAsyncResult asynchronousResult = responseStream.BeginRead(requestState.ReadBuffer, 0, BufferSize, new AsyncCallback(ReadCallBack), requestState);
HandleSyncResponseReadCompletion(asynchronousResult);
}
else
{
HandleReadCompletion(requestState);
}
}
catch (WebException e)
{
Console.WriteLine("\nReadCallBack(): Exception raised!");
Console.WriteLine("\nMessage:{0}", e.Message);
Console.WriteLine("\nStatus:{0}", e.Status);
allDone.Set();
}
}
}
Comentarios
Cautela
WebRequest, HttpWebRequest, ServicePointy WebClient están obsoletos y no debe usarlos para el nuevo desarrollo. Use HttpClient en su lugar.
El método BeginGetResponse inicia una solicitud asincrónica para una respuesta del recurso de Internet. El método de devolución de llamada asincrónica usa el método EndGetResponse para devolver el WebResponsereal .
Se produce un ProtocolViolationException en varios casos cuando las propiedades establecidas en la clase HttpWebRequest entran en conflicto. Esta excepción se produce si una aplicación establece la propiedad ContentLength y la propiedad SendChunked en truey, a continuación, envía una solicitud HTTP GET. Esta excepción se produce si una aplicación intenta enviar fragmentada a un servidor que solo admite el protocolo HTTP 1.0, donde no se admite. Esta excepción se produce si una aplicación intenta enviar datos sin establecer la propiedad ContentLength o el SendChunked es false cuando el almacenamiento en búfer está deshabilitado y en una conexión keepalive (la propiedad KeepAlive es true).
Si se produce un WebException, use las propiedades Response y Status de la excepción para determinar la respuesta del servidor.
El método BeginGetResponse requiere algunas tareas de configuración sincrónicas para completarse (resolución DNS, detección de proxy y conexión de socket TCP, por ejemplo) antes de que este método se convierta en asincrónico. Como resultado, nunca se debe llamar a este método en un subproceso de interfaz de usuario (UI) porque puede tardar mucho tiempo (hasta varios minutos en función de la configuración de red) para completar las tareas de configuración sincrónica iniciales antes de que se produzca una excepción para un error o el método se realice correctamente.
Para más información sobre el grupo de subprocesos, consulte Grupo de subprocesos administrados.
Nota
La aplicación no puede mezclar métodos sincrónicos y asincrónicos para una solicitud determinada. Si llama al método BeginGetRequestStream, debe usar el método BeginGetResponse para recuperar la respuesta.
Nota
Este miembro genera información de seguimiento al habilitar el seguimiento de red en la aplicación. Para obtener más información, consulte seguimiento de red de en .NET Framework.
