Share via


IXMLDOMDocument Interface

The IXMLDOMDocument interface represents the top level of the XML source. It includes methods to obtain or create all of the other XML DOM interfaces. For more information, see the Microsoft XML SDK 3.0 documentation available at the Microsoft Web site.

In addition to the methods inherited from the IXMLDOMNodeIXMLDOMNode Interface, the IXMLDOMDocument interface exposes the following methods.

Method

Description

createAttribute

Creates a new attribute with the specified name.

createElement

Creates an element node using the specified name.

createNode*

Creates a node using the supplied type, name, and namespace.

get_documentElement

Retrieves the root element of the document.

get_implementation

Retrieves a pointer to the IXMLDOMImplementation object for this document.

get_url*

Retrieves the canonical URL for the most recently loaded XML document.

getElementsByTagName

Retrieves a collection of elements that have the name specified in this method call.

putref_documentElement

Specifies the root element of the document.

load*

Synchronously loads an XML document with the contents of the file at the specified location.

loadXML*

Loads the supplied string into an XML document.

save*

Saves an XML document to the specified location.

* Denotes an extension to the W3C DOM.

Remarks

When the object-creation methods (such as createElement) are used on the document, nodes are created in the context of the document (the get_ownerDocument method of the node points to the document), but the node is not part of the document tree. The node is only part of the document tree when it is explicitly added to the tree by calling insertBefore, replaceChild, or appendChild (or for attributes, setAttributeNode).

Example

The following example retrieves a pointer to an IXMLDOMDocument interface.

#import “msxml3.dll”

// Declare variables.
IWMSServer*       pServer;
IXMLDOMDocument*  pPlaylist;
HRESULT           hr;

// Initialize the COM library and retrieve a pointer
// to an IWMSServer interface.
hr = CoInitialize(NULL);
hr = CoCreateInstance(CLSID_WMSServer, NULL, CLSCTX_ALL, 
       IID_IWMSServer, (void**)&pServer);
if (FAILED(hr)) goto EXIT;

// Create the playlist object.
hr = pServer->CreatePlaylist(&pPlaylist);

EXIT:
    // TODO: Release temporary COM objects and uninitialize COM.

See Also

Reference

IXMLDOMNode Interface