Export (0) Print
Expand All

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.

MethodDescription
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.

PropertyDescription

contentType

Gets the Content-Type property in the HTML request or response header.

onerror

Gets or sets the method to handle the onerror event.

onload

Gets or sets the method to handle the onload event.

onprogress

Gets or sets the method to handle the onprogress event.

ontimeout

Gets or sets the method to handle the ontimout event.

responseText

Contains the body of the response returned by the server.

timeout

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 [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Mshtml.h

IDL

Mshtml.idl

DLL

Mshtml.dll

See also

Introducing Cross-domain Request

 

 

Community Additions

ADD
Show:
© 2014 Microsoft