attributes Property1

Article
10/27/2016

Contains the list of attributes for this node.

JScript Syntax

var objXMLDOMNamedNodeMap = oXMLDOMNode.attributes;

Example

The following example creates an IXMLDOMNamedNodeMap object from a document's attributes property, and then displays the number of nodes in the object.

var xmlDoc = new ActiveXObject("Msxml2.DOMDocument.6.0");  
var oNamedNodeMap;  
xmlDoc.async = false;  
xmlDoc.load("books.xml");  
if (xmlDoc.parseError.errorCode != 0) {  
   var myErr = xmlDoc.parseError;  
   WScript.Echo("You have error " + myErr.reason);  
} else {  
   oNamedNodeMap = xmlDoc.documentElement.firstChild.attributes;  
   WScript.Echo(oNamedNodeMap.length);  
}

C/C++ Syntax

HRESULT get_attributes(  
    IXMLDOMNamedNodeMap **attributeMap);

Parameters

attributeMap[out, retval]
An IXMLDOMNamedNodeMap returned for nodes that can return attributes (Element, Entity, and Notation nodes). Returns Null for all other node types. For the valid node types, the NamedNodeMap is always returned; when there are no attributes on the element, the list length is set to zero.

C/C++ Return Values

S_OK
Success. Returns a nonnull pointer value.

S_FALSE
The value returned if the node type does not allow attributes.

E_INVALIDARG
The value returned if attributeMap is Null.

Remarks

The property is read-only. Returns IXMLDOMNamedNodeMap for nodes that can return attributes (Element, Entity, and Notation nodes). Returns Null for all other node types. For the valid node types, the NamedNodeMap is always returned; when there are no attributes on the element, the list length is set to 0.

This value depends on the value of the nodeType property.

NODE_ATTRIBUTE NODE_CDATA_SECTION NODE_COMMENT NODE_DOCUMENT NODE_DOCUMENT_FRAGMENT NODE_ENTITY_REFERENCE NODE_TEXT	Always returns Null.
NODE_ELEMENT	Returns `IXMLDOMNamedNodeMap` that contains a list of nodes corresponding to the attributes of the element.
NODE_PROCESSING_INSTRUCTION	Returns null for all processing instructions except the XML declaration, for example,`<?xml version="1.0" encoding="windows-1252" standalone="yes" ?>` For the XML declaration, the version, encoding, and standalone specifications can be accessed as attributes from the corresponding node.
NODE_DOCUMENT_TYPE	Values specified in the `<!DOCTYPE ...>` can be accessed as attributes from the node corresponding to the document type declaration. The names are "SYSTEM" and "PUBLIC". They are uppercase.
NODE_ENTITY NODE_NOTATION	Returns `IXMLDOMNamedNodeMap` that exposes the PUBLIC ID, SYSTEM ID, and NDATA as attributes.

Versioning

Implemented in:

MSXML 3.0, MSXML 6.0

Applies to

Share via