Microsoft XML 2.5 SDK


 

IXMLDOMNode::put_nodeValue Method

[This is preliminary documentation and subject to change.]

Contains the text associated with the node.

Visual Basic Syntax

objXMLDOMNode.nodeValue = strValue

C/C++ Syntax

HRESULT put_nodeValue(

    VARIANT value);

Parameters

value

[in]
Node value; depends on the nodeType property.

C/C++ Return Value

Returns S_OK if successful, or an error code otherwise.

Remarks

This value depends on the value of the nodeType property.

NODE_ATTRIBUTE 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 A string representing the text stored in the CDATA section.
NODE_COMMENT The content of the comment, exclusive of the comment begin and end sequence.
NODE_DOCUMENT, NODE_DOCUMENT_TYPE, NODE_DOCUMENT_FRAGMENT, NODE_ELEMENT, NODE_ENTITY, NODE_ENTITY_REFERENCE, NODE_NOTATION Null. Note also that attempting to set the value of the node returns an error.
NODE_PROCESSING_INSTRUCTION The content of the processing instruction, excluding the target. (The target appears in the nodeName property.)
NODE_TEXT A string representing the text stored in the text node.

The new value is also available from the nodeType property.