See Also
 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
Contains the node value expressed in its defined data type.
Script Syntax
 Copy Code
|
|
|---|---|
objValue = oXMLDOMNode.nodeTypedValue; objXMLDOMNode.nodeTypedValue = objValue; |
|
Remarks
Script Parameters
None.
Script Return Value
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++ Syntax
|
Copy Code
|
|
|---|---|
HRESULT get_nodeTypedValue( VARIANT* typedValue ); HRESULT put_nodeTypedValue( VARIANT typedValue ); |
|
Remarks
C/C++ Parameters
- 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 typedValueis Null.
C/C++ Return Values
- S_OK
-
Value returned if successful.
- E_INVALIDARG
-
Value returned if typedValueis Null.
- E_FAIL (for put_nodeTypedValue 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 nodeTypeproperty 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 nodeTypeproperty.
Although you can explicitly set the nodeTypedValueproperty 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 dataTypeproperty, and the set operation returns an error if the type coercion is not possible.
Changes to this property are also immediately available from the nodeValueproperty.
| 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:dtattribute, 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 nodeValueproperty. 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 nodeValueproperty. 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:dtattribute) or specified in the schema. If no type was specified on the instance or in the schema, returns a string identical to the nodeValueproperty. 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 nodeValueproperty. |
|
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 nodeValueproperty. |
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.