Documentation for: ASP.NET Ajax Version 1.0

This documentation is for a previous version. For the current released version, see the ASP.NET Ajax documentation on MSDN.

 

 

 

 

 

 

 

Sys.Net.WebRequestManager.executeRequest Method

Sends Web requests to the default network executor.

note

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

Syntax

Sys.Net.WebRequestManager.executeRequest(WebRequest);

Parameter

Description

WebRequest

An instance of the Sys.Net.WebRequest class.

Remarks

The executeRequestmethod 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.

Example

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

JavaScript

Sys.Net.WebRequestManager.executeRequest(wRequest);