ImportDOM Method

Microsoft Office InfoPath

Imports the specified XML data into the current form.

expression.ImportDOM(ByVal pxDoc As IXMLDocumentObject)

expression    Required. An expression that returns a reference to an XDocument object.

pxDoc    Required IXMLDocument. The XML data that is to be imported (merged) into the currently open form.

Security Level

2: Can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.

Remarks

Using the object model to import a form programmatically is equivalent to performing a merge operation using the Merge Forms command on the File menu in InfoPath.

Note  This object model member is not supported when the Disable Service Pack features option on the Advanced tab of the Options dialog box in InfoPath is selected or when Microsoft Office 2003 Service Pack 1 or later is not installed. Any form that implements this object model member in its code will generate an error message if it is opened in InfoPath when service pack features are disabled or unavailable.

Example

In the following example, the ImportDOM method of the XDocument object is used to import a form from the OnMergeRequest event handler:

XDocument::OnMergeRequest(eventObj) 
{
    XDocument.ImportDOM(eventObj.DOM);
    eventObj.ReturnStatus = true;
}