nodeName Property

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Contains the qualified name of the element, attribute, or entity reference, or a fixed string for other node types.

Script Syntax

            strValue = oXMLDOMNode.nodeName;

Remarks

Script Parameters

None.

Script Return Value

String. Node name, which varies depending on the node type.

C/C++ Syntax

HRESULT get_nodeName(
  BSTR* name
);

Remarks

C/C++ 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 name is Null.

Requirements

Header msxml2.h, msxml2.idl
Windows Embedded CE Windows CE .NET 4.0 and later

General Remarks

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.

Value Description

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".

This property applies to the following objects and interfaces:

IXMLDOMAttribute, IXMLDOMCDATASection, IXMLDOMCharacterData, IXMLDOMComment, DOMDocument, IXMLDOMDocumentFragment, IXMLDOMDocumentType, IXMLDOMElement, IXMLDOMEntity, IXMLDOMEntityReference, IXMLDOMNode, IXMLDOMNotation, IXMLDOMProcessingInstruction, IXMLDOMText, and IXTLRuntime.

See Also

Concepts

nodeType Property