nodeTypedValue Property (Compact 2013)

3/26/2014

Contains the node value expressed in its defined data type.

Syntax

objValue = oXMLDOMNode.nodeTypedValue;
objXMLDOMNode.nodeTypedValue = objValue;
HRESULT get_nodeTypedValue(
  VARIANT* typedValue
);
HRESULT put_nodeTypedValue(
  VARIANT typedValue
);

Parameters

Script

None.

C/C++

  • typedValue
    [out, retval][in] Value of this node in its defined data type, if such a data type is defined. If this node has no content, the value of typedValue is Null.

Return Value

Script

Variant. It returns the value of this node in its defined data type, if such a data type is defined. If the node has no content, this property returns Null.

C/C++

  • S_OK
    Value returned if successful.
  • E_INVALIDARG
    Value returned if typedValue is Null.
  • E_FAIL (for put_nodeTypedValue only)
    Value returned if an error occurs.

Remarks

This value depends on the value of the nodeType property of the IXMLDOMNode.

This member is an extension of the Worldwide Web Consortium (W3C) Document Object Model (DOM).

The data type for this node is defined in its dataType Property. This property also depends on the value of the node type, in the nodeType property.

Although you can explicitly set the nodeTypedValue property with a particular data type in the VARIANT, the set operation does not change the data type. The value in the VARIANT is coerced to the data type specified in the dataType property, and the set operation returns an error if the type coercion is not possible.

Changes to this property are also immediately available from the nodeValue property.

Value

Description

NODE_ATTRIBUTE

Returns the value in the data representation of the type specified in the schema for the attribute. (Data types are specified using the dt:dt attribute, and because attributes cannot be applied to attributes, the attribute's data type can be specified only in the schema.) If no type was specified, returns a string identical to the nodeValue property. If the new value is not of the type specified in the schema or cannot be coerced to the type specified in the schema, then an error occurs.

NODE_CDATA_SECTION, NODE_COMMENT, NODE_DOCUMENT, NODE_DOCUMENT_FRAGMENT, NODE_DOCUMENT_TYPE, NODE_ENTITY, NODE_NOTATION, NODE_PROCESSING_INSTRUCTION

Returns a string that is equal to the nodeValue property. These node types do not have data types.

NODE_ELEMENT

Returns the value in the data representation of the type specified on the element instance (using the dt:dt attribute) or specified in the schema. If no type was specified on the instance or in the schema, returns a string identical to the nodeValue property. If the element has an attribute data type, returns null.

NODE_ENTITY_REFERENCE

Returns the value in the data representation of the type specified for the referenced entity. This is limited to entities with a single data type on the root level element of the subtree corresponding to the entity. If no data type was specified, returns a string identical to the nodeValue property.

NODE_TEXT

Returns the value in the data representation of the type of the containing element. If the containing element was not typed, returns a string identical to the nodeValue property.

Data Type Mapping

VARIANT returned

Corresponding element data type

VT_BSTR

string

VT_BSTR

number

VT_I4

Int

VT_CY

Fixed.14.4

VT_BOOL

Boolean

VT_DATE

dateTime

VT_DATE

dateTime.tz

VT_DATE

Date

VT_DATE

Time

VT_DATE

Time.tz

VT_I1

i1 byte

VT_I2

i2

VT_I4

i4, int

VT_UI1

ui1

VT_UI2

ui2

VT_UI4

ui4

VT_FLOAT

r4

VT_DOUBLE

r8, float

VT_BSTR

uuid

VT_ARRAY

bin.hex

VT_ARRAY

bin.base64

This property is read/write, and applies to the following objects and interfaces:

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

Requirements

Header

msxml2.h,
msxml2.idl

See Also

Reference

XML DOM Properties
nodeType Property
nodeValue Property