Partager via


IXMLDOMDocument Object (C#)

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

The IXMLDOMDocument object supports the following properties and methods.

Property

Description

attributes

Contains the list of attributes for this node. Read-only.

childNodes

Contains a node list containing the children (for nodes that can have children). Read-only.

documentElement

Contains the root element of the document. Read/write.

firstChild

Contains the first child of this node. Read-only.

implementation

Contains the IXMLDOMImplementationIXMLDOMImplementation Object (C#) for this document. Read-only.

lastChild

Contains the last child of this node. Read-only.

nextSibling

Contains the next sibling of this node in the parent's child list. Read-only.

nodeName

Contains the qualified name of the element, attribute, or entity reference, or a fixed string for other node types. Read-only.

nodeType

Specifies the XML DOM node type, which determines valid values and whether the node can have child nodes. Read-only.

nodeTypeString*

Contains the node type in string form. Read-only.

nodeValue

Contains the text associated with the node. Read/write.

ownerDocument

Contains the root of the document that contains this node. Read-only.

parentNode

Contains the parent node (for nodes that can have parents). Read-only.

previousSibling

Contains the left sibling of this node. Read-only.

url*

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

Method

Description

appendChild

Appends the supplied new child as the last child of this node.

cloneNode

Creates a new node that is an exact clone of this node.

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.

getElementsByTagName

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

hasChildNodes

Returns true if this node has children.

insertBefore

Inserts a child node to the left of the specified node or at the end of the list.

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.

removeChild

Removes the specified child node from the list of children and returns it.

replaceChild

Returns the specified old child node and replaces it with the supplied new child node.

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 ownerDocument property 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 demonstrates how to create an IXMLDOMDocument object.

using Microsoft.WindowsMediaServices.Interop;
using interop_msxml;

// Declare variables.
WMSServer Server;
IXMLDOMDocument Playlist;

try {
    // Create a new WMSServer object.
    Server = new WMSServerClass();

    // Create a new playlist object.
    Playlist = Server.CreatePlaylist();
}
catch (Exception e) {
    // TODO: Handle exceptions.
}

See Also

Reference

IWMSServer Object (C#)