IXMLDOMElement

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Represents the element object.

Methods

The following table shows the methods for IXMLDOMElement.

Method	Description
appendChild	Appends newChild 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 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.
normalize	Normalizes all descendant elements; combines two or more adjacent text nodes into one unified text node.
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	Replaces the specified old child node with the supplied new child node in the set of children of this node, and returns the old child node.
selectNodes*	Applies the specified pattern-matching operation to this node's context and returns the list of matching nodes.
selectSingleNode*	Applies the specified pattern-matching operation to this node's context and returns the first matching node.
setAttribute	Sets the value of the named attribute.
setAttributeNode	Adds or changes the supplied attribute node on this element.
transformNode*	Processes this node and its children using the supplied Extensible Stylesheet Language Transformations (XSLT) style sheet and returns the resulting transformation.
transformNodeToObject*	Processes this node and its children using the supplied XSLT style sheet and returns the resulting transformation in the supplied object.

* denotes an extension to the W3C DOM.

Properties

The following table shows the properties for IXMLDOMElement.

Property	Description
attributes	Contains the list of attributes for this node. Read-only.
baseName*	Returns the base name for the name qualified with the namespace. Read-only.
childNodes	Contains a node list containing the children (for nodes that can have children). Read-only.
dataType*	Specifies the data type for this node. Read/write.
definition*	Returns the definition of the node in the document type definition (DTD) or schema.
firstChild	Contains the first child of this node. Read-only.
lastChild	Returns the last child node. Read-only.
namespaceURI*	Returns the Uniform Resource Identifier (URI) for the namespace. 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 Document Object Model (DOM) node type, which determines valid values and whether the node can have child nodes. Read-only.
nodeTypeString*	Returns 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.
parsed*	Contains True if this node and all descendants have been parsed and instantiated; False if any nodes remain to be parsed. Read-only.
prefix*	Returns the namespace prefix. Read-only.
previousSibling	Contains the left sibling of this node. Read-only.
specified*	Indicates whether the node (usually an attribute) is explicitly specified or derived from a default value in the DTD or schema. Read-only.
tagName	Contains the element name (the name that appears within the tag). Read-only.
text*	Contains the text content of the node and its subtrees. Read/write.
xml*	Contains the XML representation of the node and all its descendants. Read-only.

* denotes an extension to the World Wide Web Consortium (W3C) DOM.

Events

None.

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 an 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 an element, you can also call the getAttribute method, which returns an IXMLDOMNamedNodeMap collection object that contains all the element's attributes.

This interface inherits all of the methods, properties, and events of IXMLDOMNode.

Setting	Version-independent	Version-dependent
ProgID	Msxml2.DOMDocument	Msxml2.DOMDocument.3.0

See Also

Reference

IXMLDOMNamedNodeMap
IXMLDOMText
IXMLDOMNode

Concepts

getAttribute Method