Share via

nodeName Property1

  • Article
  • 10/27/2016

 

Returns the qualified name for attribute, document type, element, entity, or notation nodes. Returns a fixed string for all other node types. Read-only.

Script Syntax

strValue = oXMLDOMNode.nodeName;

Example

The following script example creates an IXMLDOMNode object and displays its name.

var xmlDoc = new ActiveXObject("Msxml2.DOMDocument.3.0");
var currNode;
xmlDoc.async = false;
xmlDoc.load("books.xml");
if (xmlDoc.parseError.errorCode != 0) {
   var myErr = xmlDoc.parseError;
   WScript.Echo("You have error " + myErr.reason);
} else {
   currNode = xmlDoc.documentElement.childNodes.item(0);
   WScript.Echo(currNode.nodeName);
}

Visual Basic Syntax

strValue = oXMLDOMNode.nodeName

C/C++ Syntax

HRESULT get_nodeName(  
    BSTR *name);

Parameters

name[out, retval]
Node name, which varies depending on the node type.

C/C++ Return Values

S_OK
Value returned if successful.

E_INVALIDARG
Value returned if the name parameter is Null.

Remarks

String. The property is read-only and always contains a non-empty string. The nodeName property contains the qualified name for the element, attribute, or entity reference. For example, it returns xxx:yyy for the element <xxx:yyy>.

The node name value varies, depending on the nodeType property.

NODE_ATTRIBUTE Contains the name of the attribute.
NODE_CDATA_SECTION Contains the literal string "#cdata-section".
NODE_COMMENT Contains the literal string "#comment".
NODE_DOCUMENT Contains the literal string "#document".
NODE_DOCUMENT_TYPE Contains the name of the document type; for example, xxx in <!DOCTYPE xxx ...>.
NODE_DOCUMENT_FRAGMENT Contains the literal string "#document-fragment".
NODE_ELEMENT Contains the name of the XML tag, with any namespace prefix included if present.
NODE_ENTITY Contains the name of the entity.
NODE_ENTITY_REFERENCE Contains the name of the entity referenced. Note that the name does not include the leading ampersand or the trailing semicolon. The name includes the namespace if one is present.
NODE_NOTATION Contains the name of the notation.
NODE_PROCESSING_INSTRUCTION Contains the target; the first token following the <? characters.
NODE_TEXT Contains the literal string "#text".

Versioning

Implemented in: MSXML 3.0, MSXML 6.0

Applies to

IXMLDOMAttribute | IXMLDOMCDATASection | IXMLDOMCharacterData | IXMLDOMComment | IXMLDOMDocument-DOMDocument | IXMLDOMDocumentFragment | IXMLDOMDocumentType | IXMLDOMElement | IXMLDOMEntity | IXMLDOMEntityReference | IXMLDOMNode | IXMLDOMNotation | IXMLDOMProcessingInstruction | IXMLDOMText

See Also

nodeType Property1