nodeValue Property

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Contains the text associated with the node.

Script Syntax

            objValue = oXMLDOMNode.nodeValue;
objXMLDOMNode.nodeValue = objValue;

Remarks

Script Parameters

None.

Script Return Value

Variant. Node value; depends on the nodeType property.

C/C++ Syntax

HRESULT get_nodeValue(
  VARIANT* value
);
HRESULT get_nodeValue(
  VARIANT value
);

Remarks

C/C++ Parameters

  • value
    [out, retval][in] Node value; depends on the nodeType property.

C/C++ Return Values

  • S_OK
    Value returned if successful.
  • S_FALSE (for get_nodeValue only)
    Value when returning Null.
  • E_INVALIDARG (for get_nodeValue only)
    Value returned if value is Null.
  • E_FAIL (for get_nodeValue only)
    Value returned if an error occurs.

Requirements

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

General Remarks

This value depends on the value of the nodeType property.

Value Description

NODE_ATTRIBUTE

Contains a string representing the value of the attribute. For attributes with subnodes, this is the concatenated text of all subnodes with entities expanded. Setting this value deletes all children of the node and replaces them with a single text node containing the value written.

NODE_CDATA_SECTION

Contains a string representing the text stored in the CDATA section.

NODE_COMMENT

Contains the content of the comment, exclusive of the comment's start and end sequence.

NODE_DOCUMENT, NODE_DOCUMENT_TYPE, NODE_DOCUMENT_FRAGMENT, NODE_ELEMENT, NODE_ENTITY, NODE_ENTITY_REFERENCE, NODE_NOTATION

Contains Null. Note that attempting to set the value of nodes of these types generates an error.

NODE_PROCESSING_INSTRUCTION

Contains the content of the processing instruction, excluding the target. (The target appears in the nodeName Property.)

NODE_TEXT

Contains a string representing the text stored in the text node.

This property is read/write, and 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

Other Resources