Sys.Net.WebRequestManager.executeRequest Method

Sends Web requests to the default network executor.


This member supports the client-script infrastructure and is not intended to be used directly from your code.






An instance of the Sys.Net.WebRequest class.


The executeRequest method sends Web requests to the default executor. To execute a Web request, you must call the invoke method.

The WebRequestManager class performs the following tasks when passing control to a network executor:

  • If the request does not already have an executor, it creates an instance of the default network executor class and sets the executor instance of the request object.

  • Associates the current WebRequest instance with the default executor instance. This enables the executor to access the relevant request information from the WebRequest instance so that the executor can create a network request.

  • Adds a referrer property to the header collection and sets it to the value of the document URL.

  • Before it sends the request to the network executor, raises the cancellable add_invokingRequest event.

  • If the event arguments indicate that the call was canceled, immediately returns from the current method call. In that case, the handler specified by the add_completedRequest method is never called.

  • Reroutes the completion event to the WebRequest instance to make sure that the add_completedRequest event handler is called. This occurs after the method specified by the add_invokingRequest returns, and only if you have registered the add_completedRequest method.

  • Passes control to the default Web request executor.


The following example shows how to execute a Web request. This code is part of a complete example found in the WebRequestManager class overview.


See Also


Sys.Net.WebRequestManager Class

Sys.Net.WebRequestExecutor Class

Sys.Net.XMLHttpExecutor Class