IXMLDOMElement

 

Description

 

Represents the element object.

 

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 access the attributes property, which returns an IXMLDOMNamedNodeMap collection object that contains all the element's attributes.

 

Versioning

 

Implemented in: MSXML 2.0 and later

 

IXMLDOMElement Members

 

The following tables show the properties, methods, and events.

 

In C++, this interface inherits from IXMLDOMNode.

 

Properties

 

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 nodes. 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 the 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 the node. Read-only.

parentNode

Contains the parent node. Read-only.

parsed*

Indicates the parsed status of the node and child nodes. Read-only.

prefix*

Returns the namespace prefix. Read-only.

previousSibling

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

specified*

Indicates whether the node (usually an attribute) is explicitly specified or derived from a default value in the document type definition (DTD) or schema. Read-only.

tagName

Contains the element name. Read-only.

text*

Represents the text content of the node or the concatenated text representing the node and its descendants. 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.

 

Methods

 

appendChild

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

cloneNode

Clones a new node.

getAttribute

Gets the value of the attribute.

getAttributeNode

Gets the attribute node.

getElementsByTagName

Returns a list of all descendant elements that match the supplied name.

hasChildNodes

Provides a fast way to determine whether a 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 by combining 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.

selectNodes*

Applies the specified pattern-matching operation to this node's context and returns the list of matching nodes as IXMLDOMNodeList.

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

Sets or updates the supplied attribute node on this element.

transformNode*

Processes this node and its children using the supplied XSL 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.

 

Events

 

None.

 

Valid XHTML 1.0 Transitional