createNode Method
Creates a node using the supplied type, name, and namespace.
var objXMLDOMNode = oXMLDOMDocument.createNode(Type, name, namespaceURI);
Parameters
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.6.0"); var MyNode; var namedNodeMap; xmlDoc.async = false; xmlDoc.loadXML("<root><child/></root>"); MyNode = xmlDoc.createNode(2, "Sci-Fi", ""); namedNodeMap = xmlDoc.documentElement.childNodes.item(0).attributes; namedNodeMap.setNamedItem(MyNode); WScript.Echo(xmlDoc.documentElement.xml);
Output
<root><child Sci-Fi=""/></root> | |
The name parameter depends on the value of the Type parameter:
|
NODE_ATTRIBUTE |
The name of the attribute. |
|
NODE_CDATA_SECTION, NODE_COMMENT, NODE_DOCUMENT, NODE_DOCUMENT_FRAGMENT, NODE_TEXT |
The nodeName property for these node types is a constant value; the name parameter is ignored. |
|
NODE_DOCUMENT_TYPE |
The name of the document type; for example, the xxx in <!DOCTYPE xxx ...>. |
|
NODE_ELEMENT |
The name of the XML tag, with any namespace prefix included if present. |
|
NODE_ENTITY |
The name of the entity. |
|
NODE_ENTITY_REFERENCE |
The name of the entity referenced. The name does not include the leading ampersand or the trailing semicolon. The name includes the namespace, if one is present. |
|
NODE_NOTATION |
The name of the notation. |
|
NODE_PROCESSING_INSTRUCTION |
The target, the first token following the <? characters. |
You cannot create a node of type NODE_DOCUMENT, NODE_DOCUMENT_TYPE, NODE_ENTITY, or NODE_NOTATION.
When a node is created, it is created in the context of a namespace if one is supplied (if the namespaceURI parameter is supplied). If one is not supplied, the node is created in the namespace of the document. If the namespaceURI parameter is specified, the node is created in the context of the namespaceURI parameter with the prefix specified on the node name.
For node types that do not have names, the empty string, "", should be passed as the name parameter.
For elements and entity references, when the value of the namespaceURI parameter is anything other than "", and the value of the name parameter does not contain a prefix (xxx in xxx:yyy), the value of the namespaceURI parameter is treated as the default namespace.
Attributes cannot be scoped to a default namespace, and other elements are not qualified to a particular namespace; they are treated as being from the namespace defined by the document itself.
When the value of namespaceURI parameter is the empty string, "", the node is created without a namespace. Creating a qualified node without specifying a nonempty namespaceURI returns an error. This member is an extension of the Worldwide Web Consortium (W3C) Document Object Model (DOM).
