Microsoft XML SDK 2.6 - XML Reference

IXMLDOMNode::dataType Method

IXMLDOMNode::get_dataType Method

Specifies the data type for this node.

Visual Basic Syntax

strValue = oXMLDOMNode.dataType

C/C++ Syntax

HRESULT get_dataType(
    VARIANT *dataTypeName);

Parameters

dataTypeName [out]
VARIANT can be a BSTR that contains the data type name, or VT_NULL if no data type is defined.

C/C++ Return Values

S_OK
Value returned if successful.
S_FALSE
Value returned if the node is not typed.
E_INVALIDARG
Value returned if dataTypeName is Null.

IXMLDOMNode::put_dataType Method

Specifies the data type for this node.

Visual Basic Syntax

objXMLDOMNode.dataType = strValue

C/C++ Syntax

HRESULT put_dataType(
    VARIANT *dataTypeName);

Parameters

dataTypeName [out]
VARIANT can be a BSTR that contains the data type name, or VT_NULL if no data type is defined.

C/C++ Return Values

S_OK
Value returned if successful.
E_FAIL
Value returned if an error occurs.

Remarks

This value depends on the value of the IXMLDOMNode interface's nodeType method.

NODE_ATTRIBUTE Contains the string representation of the data type specifier included in the schema. Null if no data type is specified.
NODE_CDATA_SECTION, NODE_COMMENT, NODE_DOCUMENT, NODE_DOCUMENT_FRAGMENT, NODE_DOCUMENT_TYPE, NODE_ENTITY, NODE_NOTATION, NODE_PROCESSING_INSTRUCTION, NODE_TEXT Contains the constant string value "string". These node types do not have data types, so the dataType method cannot be set for these node types. Attempts to set this method are ignored.
NODE_ELEMENT Contains the string representation of the data type specifier included on the instance of the element or in the schema. Null if no data type is specified.
NODE_ENTITY_REFERENCE Contains the string representation of the data type specifier 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. Contains Null if no data type was specified. It is not possible to set the data type of an entity reference. The data type must be set directly on the referenced element. Attempts to set the value of the dataType method are ignored.

This method represents a convenient alternative way to obtain the data type specified in this node's dt:dt attribute.

Changes to the data type also cause updates to the nodeTypedValue method.

See Also

IXMLDOMNode Interface