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.XMLHttpExecutor Class

Makes asynchronous network requests by using the browser's XMLHTTP support.

Namespace: Sys.Net

Inherits: None

Syntax

var executor = new Sys.Net.XMLHttpExecutor();

Members

Name

Description

abort Method

Stops the pending network request issued by the executor.

executeRequest Method

Executes a network request as specified in the associated WebRequest instance.

getAllResponseHeaders Method

Returns the response headers.

getResponseHeader Method

getResponseHeader Method

Gets the value of a specified response header.

aborted Property

Returns a value that indicates whether the executor was aborted.

responseAvailable Property

Returns a value that indicates whether the network request returned without being aborted or timing out.

responseData Property

Gets the text representation of the response body.

started Property

Returns a value that indicates whether the executor has forwarded the request to the browser's XMLHTTP object.

statusCode Property

Gets the status code of the browser's XMLHTTP object.

statusText Property

Gets the status text from the browser's XMLHTTP object.

timedOut Property

Returns a value that indicates whether the executor timed out.

xml Property

Returns an XMLDOM object that contains the XML response from the browser's XMLHTTP object.

Remarks

The XmlHttpExecutor class acts as the default executor and is an implementation of the WebRequestExecutor abstract class.

Because the default executor is already set, you do not have to create an instance of the class and associate it with the Web request. However, if you define a custom executor, you must create an instance of the executor and set it as the default executor of the Web request.

After the network call is completed, the XmlHttpExecutor object should be used only to obtain response data, after which it should be discarded.

note

For more information about the XMLHTTP object, see About Native XMLHTTP.

Example

The following example shows how to use the XmlHttpExecutor class by using its methods and properties.