IXMLDOMElement Object (Visual Basic .NET)
The IXMLDOMElement object represents the element object. For more information, see the Microsoft XML SDK 3.0 documentation available at the Microsoft Web site.
The IXMLDOMElement 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. |
firstChild |
Contains the first child of this node. 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 |
Returns 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. |
tagName |
Contains the element name (the name that appears within the tag). Read-only. |
* Denotes an extension to the W3C DOM.
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. |
getAttribute |
Gets the value of the named attribute. |
getAttributeNode |
Gets the named attribute node. |
getElementsByTagName |
Returns a list of all descendant elements that match the supplied name. |
hasChildNodes |
Returns a Boolean value indicating whether this node has children. |
insertBefore |
Inserts a child node to the left of the specified node or at the end of the list. |
removeAttribute |
Removes or replaces the named attribute. |
removeAttributeNode |
Removes the specified attribute from this element. |
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. |
setAttribute |
Sets the value of the named attribute. |
setAttributeNode |
Adds or changes the supplied attribute node on this element. |
Remarks
Element nodes are among the most common objects in the XML document tree. Element nodes can have attributes associated with them. By definition, attributes are not defined as child nodes of the element and are not considered to be part of the document tree. Accordingly, the IXMLDOMElement object provides methods to make it easier to manage attributes, including methods to associate an attribute with an element, and to retrieve an attribute object and the attribute value by name.
To retrieve the set of all attributes associated with the element, you can also call the getAttribute method, which returns an IXMLDOMNamedNodeMap collection object that contains all the attributes of the element.
Example
The following example creates an IXMLDOMElement object and assigns it to the root element of an XML document.
Imports interop_msxml
Imports Microsoft.WindowsMediaServices.Interop
On Error GoTo Err
' Declare variables.
Dim Server As New WMSServerClass()
Dim Playlist As IXMLDOMDocument
Dim newRoot As IXMLDOMElement
' Create a new playlist object.
Set Playlist = Server.CreatePlaylist
' Create a new element named root.
Set newRoot = Playlist.createElement("root")
' Assign newRoot as the new document
' element for the XML document.
Set Playlist.documentElement = newRoot
Exit Sub
Err:
' TODO: Handle errors.