IXMLDOMAttribute (Compact 2013)

  • Article

3/26/2014

Represents an attribute of the IXMLDOMElement. Valid and default values for the attribute are defined in a document type definition (DTD) or schema.

IXMLDOMAttribute inherits IXMLDOMNode but are not actually child nodes of the element and are not considered part of the document tree. Attributes are considered members of their associated elements rather than independent and separate. Thus IXMLDOMAttribute parentNode, previousSibling, and nextSibling members have the value Null.

Methods

The following table shows the methods for IXMLDOMAttribute.

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.

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.

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.

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.

Properties

The following table shows the properties for IXMLDOMAttribute.

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. Read-only.

firstChild

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

lastChild

Returns the last child node. Read-only.

name

Contains the attribute name. Read-only.

namespaceURI*

Returns the 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.

nodeTypedValue*

Contains this node's value, expressed in its defined data type. Read/write.

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.

text

Contains the text content of the node and its subtrees. Read/write.

value

Contains the attribute value. 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

Attribute nodes cannot be the immediate children of IXMLDOMDocumentFragment. However, they can be associated with element nodes that are children of IXMLDOMDocumentFragment node.

The relationship between the value and specified members can be summarized as follows: If the attribute has an assigned value in the document and the specified member is True, the value is the assigned value. If the attribute has no assigned value in the document and has a default value in the DTD, the specified member is False and the value is the default value in the DTD. If the attribute has no assigned value in the document and has a value of #IMPLIED in the DTD, the attribute does not appear in the structure model of the document.

In XML, the value of an attribute is represented by the child nodes of the attribute node because the value can contain entity references. Thus attributes that contain entity references will have a child list containing both text nodes and entity reference nodes. In addition, because the attribute type might be unknown, there are no tokenized attribute values.

Requirements

Header

msxml2.h,
msxml2.idl

Library

uuid.lib

See Also

Reference

XML DOM Objects/Interfaces
IXMLDOMNode
IXMLDOMElement
IXMLDOMDocumentFragment
specified Property