Script Syntax

var objXMLDOMNode = oXMLDOMDocument.createNode(Type, name, namespaceURI);

Parameters

Type

A variant. A value that uniquely identifies the node type. This can be specified using either the integer value or the string value. For the complete list of values, see XML DOM Enumerated Constants or the description for the name parameter.

name

A string containing the value for the new node's nodeName property. The relationship between the name and Type parameters is summarized in the Remarks section of this topic.

namespaceURI

A string defining the namespace URI. If specified, the node is created in the context of the namespaceURI parameter with the prefix specified on the node name. If the name parameter does not have a prefix, this is treated as the default namespace.

Return Value

Object. Returns the newly created node.

Example

The following script example creates an attribute node called Sci-Fi and adds it to the attributes for the DOMDocument object.

var xmlDoc = new ActiveXObject("Msxml2.DOMDocument.5.0");
var MyNode;
var namedNodeMap;
xmlDoc.async = false;
xmlDoc.load("books.xml");
MyNode = xmlDoc.createNode(2, "Sci-Fi", "");
namedNodeMap = xmlDoc.documentElement.childNodes.item(0).attributes;
namedNodeMap.setNamedItem(MyNode);
alert(xmlDoc.documentElement.xml);

Visual Basic Syntax

Set objXMLDOMNode = oXMLDOMDocument.createNode(Type, name, namespaceURI)

Parameters

Type

A variant. A value that uniquely identifies the node type. This can be specified using either the integer value or the string value. For the complete list of values, see the XML DOM Enumerated Constants or the description for the name parameter.

name

A string containing the value for the new node's nodeName property. The relationship between the name and Type parameters is summarized in the Remarks section of this topic.

namespaceURI

A string defining the namespace URI. If specified, the node is created in the context of the namespaceURI parameter with the prefix specified on the node name. If the name parameter does not have a prefix, this is treated as the default namespace.

Return Value

An object. Returns the newly created node.

Example

The following Microsoft® Visual Basic® example creates an attribute node called Sci-Fi and adds it to the attributes for the DOMDocument object.

Dim xmlDoc As New Msxml2.DOMDocument50
Dim MyNode As IXMLDOMNode
Dim namedNodeMap As IXMLDOMNamedNodeMap
xmlDoc.async = False
xmlDoc.Load ("books.xml")
If (xmlDoc.parseError.errorCode <> 0) Then
   Dim myErr
   Set myErr = xmlDoc.parseError
   MsgBox("You have error " & myErr.reason)
Else
   Set MyNode = xmlDoc.createNode(NODE_ATTRIBUTE, "Sci-Fi", "")
   Set namedNodeMap = xmlDoc.documentElement.childNodes.Item(0).Attributes
   namedNodeMap.setNamedItem MyNode
   MsgBox (xmlDoc.documentElement.xml)
End If

C/C++ Syntax

HRESULT createNode(
    VARIANT Type,
    BSTR name,
    BSTR namespaceURI,
    IXMLDOMNode **node);

Parameters

Type [in]

The value that uniquely identifies the node type. This can be specified using either the integer value or the string value. For the complete list of values, see the XML DOM Enumerated Constants or the description given for the name parameter.

name [in]

The value for the new node's nodeName property. The relationship between the name and Type parameters is summarized in the Remarks section of this topic.

namespaceURI [in]

The namespace URI. If specified, the node is created in the context of the namespaceURI parameter with the prefix specified on the node name. If the name parameter does not have a prefix, this is treated as the default namespace.

node [out, retval]

The newly created node.

C/C++ Return Values

S_OK

The value returned if successful.

E_INVALIDARG

The value returned if the node parameter is Null.

E_FAIL

The value returned if an error occurs.