Microsoft XML 2.5 SDK


 

IXMLDOMNode::put_dataType Method

[This is preliminary documentation and subject to change.]

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 object's nodeType property.

NODE_ATTRIBUTE Contains the string representation of the data type specifier included in the schema, or NULL if no data type was 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 property cannot be set for these node types. Attempts to set this property are ignored.
NODE_ELEMENT Contains the string representation of the data type specifier included on the instance of the element or in the schema, or NULL if no data type was 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 property are ignored.

This property 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 property.