WebRequest.BeginGetResponse Method (AsyncCallback, Object)
When overridden in a descendant class, begins an asynchronous request for an Internet resource.
Assembly: System (in System.dll)
[HostProtectionAttribute(SecurityAction.LinkDemand, ExternalThreading = true)] public virtual IAsyncResult BeginGetResponse( AsyncCallback callback, object state )
Parameters
- callback
-
Type:
System.AsyncCallback
The AsyncCallback delegate.
- state
-
Type:
System.Object
An object containing state information for this asynchronous request.
| Exception | Condition |
|---|---|
| NotImplementedException | Any attempt is made to access the method, when the method is not overridden in a descendant class. |
The BeginGetResponse method starts an asynchronous request for a response. The callback method that implements the AsyncCallback delegate uses the EndGetResponse method to return the WebResponse from the Internet resource.
Note |
|---|
The WebRequest class is an abstract class. The actual behavior of WebRequest instances at run time is determined by the descendant class returned by the WebRequest.Create method. For more information about default values and exceptions, see the documentation for the descendant classes, such as HttpWebRequest and FileWebRequest. |
The following example uses BeginGetResponse to asynchronously request the target resource. When the resource has been obtained, the specified callback method will be executed.
using System; using System.Net; using System.IO; using System.Text; using System.Threading; public class RequestState { // This class stores the state of the request. const int BUFFER_SIZE = 1024; public StringBuilder requestData; public byte[] bufferRead; public WebRequest request; public WebResponse response; public Stream responseStream; public RequestState() { bufferRead = new byte[BUFFER_SIZE]; requestData = new StringBuilder(""); request = null; responseStream = null; } } class WebRequest_BeginGetResponse { public static ManualResetEvent allDone= new ManualResetEvent(false); const int BUFFER_SIZE = 1024; static void Main() { try { // Create a new webrequest to the mentioned URL. WebRequest myWebRequest= WebRequest.Create("http://www.contoso.com"); // Please, set the proxy to a correct value. WebProxy proxy=new WebProxy("myproxy:80"); proxy.Credentials=new NetworkCredential("srikun","simrin123"); myWebRequest.Proxy=proxy; // Create a new instance of the RequestState. RequestState myRequestState = new RequestState(); // The 'WebRequest' object is associated to the 'RequestState' object. myRequestState.request = myWebRequest; // Start the Asynchronous call for response. IAsyncResult asyncResult=(IAsyncResult) myWebRequest.BeginGetResponse(new AsyncCallback(RespCallback),myRequestState); allDone.WaitOne(); // Release the WebResponse resource. myRequestState.response.Close(); Console.Read(); } catch(WebException e) { Console.WriteLine("WebException raised!"); Console.WriteLine("\n{0}",e.Message); Console.WriteLine("\n{0}",e.Status); } catch(Exception e) { Console.WriteLine("Exception raised!"); Console.WriteLine("Source : " + e.Source); Console.WriteLine("Message : " + e.Message); } } private static void RespCallback(IAsyncResult asynchronousResult) { try { // Set the State of request to asynchronous. RequestState myRequestState=(RequestState) asynchronousResult.AsyncState; WebRequest myWebRequest1=myRequestState.request; // End the Asynchronous response. myRequestState.response = myWebRequest1.EndGetResponse(asynchronousResult); // Read the response into a 'Stream' object. Stream responseStream = myRequestState.response.GetResponseStream(); myRequestState.responseStream=responseStream; // Begin the reading of the contents of the HTML page and print it to the console. IAsyncResult asynchronousResultRead = responseStream.BeginRead(myRequestState.bufferRead, 0, BUFFER_SIZE, new AsyncCallback(ReadCallBack), myRequestState); } catch(WebException e) { Console.WriteLine("WebException raised!"); Console.WriteLine("\n{0}",e.Message); Console.WriteLine("\n{0}",e.Status); } catch(Exception e) { Console.WriteLine("Exception raised!"); Console.WriteLine("Source : " + e.Source); Console.WriteLine("Message : " + e.Message); } } private static void ReadCallBack(IAsyncResult asyncResult) { try { // Result state is set to AsyncState. RequestState myRequestState = (RequestState)asyncResult.AsyncState; Stream responseStream = myRequestState.responseStream; int read = responseStream.EndRead( asyncResult ); // Read the contents of the HTML page and then print to the console. if (read > 0) { myRequestState.requestData.Append(Encoding.ASCII.GetString(myRequestState.bufferRead, 0, read)); IAsyncResult asynchronousResult = responseStream.BeginRead( myRequestState.bufferRead, 0, BUFFER_SIZE, new AsyncCallback(ReadCallBack), myRequestState); } else { Console.WriteLine("\nThe HTML page Contents are: "); if(myRequestState.requestData.Length>1) { string sringContent; sringContent = myRequestState.requestData.ToString(); Console.WriteLine(sringContent); } Console.WriteLine("\nPress 'Enter' key to continue........"); responseStream.Close(); allDone.Set(); } } catch(WebException e) { Console.WriteLine("WebException raised!"); Console.WriteLine("\n{0}",e.Message); Console.WriteLine("\n{0}",e.Status); } catch(Exception e) { Console.WriteLine("Exception raised!"); Console.WriteLine("Source : {0}" , e.Source); Console.WriteLine("Message : {0}" , e.Message); } } }
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
