IHTMLXDomainRequest interface
Implements cross-domain Asynchronous JavaScript and XML (AJAX) requests between the browser and a server.
Members
The IHTMLXDomainRequest interface inherits from the IDispatch interface. IHTMLXDomainRequest also has these types of members:
Methods
The IHTMLXDomainRequest interface has these methods.
| Method | Description |
|---|---|
| abort |
The abort method terminates a pending send. |
| open (XDomainRequest) |
Creates a connection with a domain's server. |
| send (XDomainRequest) |
Transmits a data string to the server for processing. |
Properties
The IHTMLXDomainRequest interface has these properties.
| Property | Description |
|---|---|
|
Gets the Content-Type property in the HTML request or response header. | |
|
Gets or sets the method to handle the onerror event. | |
|
Gets or sets the method to handle the onload event. | |
|
Gets or sets the method to handle the onprogress event. | |
|
Gets or sets the method to handle the ontimout event. | |
|
Contains the body of the response returned by the server. | |
|
Gets or sets the value of the timeout property. |
Remarks
Cross-domain requests require mutual consent between the Web page and the server.
You can initiate a cross-domain request by creating an
XDomainRequest (XDR) object with the window object,
and opening a connection to a URL.
When sending the request, Windows Internet Explorer 8 includes an
XDomainRequest: 1 HTTP request header.
The connection is completed only if the server responds with an XDomainRequestAllowed: 1 response header.
To use the XDR protocol, you first create an XDomainRequest object. Then you use the IHTMLXDomainRequest::open method to establish a connection with a server. Once a connection is opened, the IHTMLXDomainRequest::send method transmits data strings to the server for processing. For example:
// 1. Create XDR object
xdr = new XDomainRequest();
// 2. Open connection with server using POST method
xdr.open("POST", "http://www.contoso.com/xdr.txt");
// 3. Send string data to server
xdr.send("data to be processed");
For more information, see XDomainRequest.
Requirements
|
Minimum supported client |
Windows XP with SP2 |
|---|---|
|
Minimum supported server |
Windows Server 2003 |
|
Header |
|
|
IDL |
|
|
DLL |
|
See also