Sys.Net.WebRequestManager.executeRequest Method

Sends Web requests to the default network executor.

Syntax

Sys.Net.WebRequestManager.executeRequest(WebRequest);

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);