Script Syntax

var objXMLDOMAttribute = oXMLDOMDocument.createAttribute(name);

Parameters

name

A string specifying the name of the new attribute object. This name is subsequently available as the new node's nodeName property.

Return Value

An object. Returns the new IXMLDOMAttribute object.

Example

The following script example creates a new attribute called ID and adds it to the attributes of the DOMDocument object.

var xmlDoc = new ActiveXObject("Msxml2.DOMDocument.5.0");
var root;
var newAtt;
var namedNodeMap;
xmlDoc.async = false;
xmlDoc.load("books.xml");
if (xmlDoc.parseError.errorCode != 0) {
   var myErr = xmlDoc.parseError;
   alert("You have error " + myErr.reason);
} else {
   root = xmlDoc.documentElement;
   newAtt = xmlDoc.createAttribute("ID");
   namedNodeMap = root.attributes;
   namedNodeMap.setNamedItem(newAtt);
   for (var i=0; i<namedNodeMap.length; i++) {
      alert(namedNodeMap.item(i).xml);
   }
}

Visual Basic Syntax

Set objXMLDOMAttribute = oXMLDOMDocument.createAttribute(name)

Parameters

name

A string specifying the name of the new attribute object. This name is subsequently available as the new node's nodeName property.

Return Value

An object. Returns the new IXMLDOMAttribute object.

Example

The following Visual Basic example creates a new attribute called ID and adds it to the attributes of the DOMDocument object.

Dim xmlDoc As New Msxml2.DOMDocument50
Dim root As IXMLDOMElement
Dim newAtt As IXMLDOMAttribute
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 root = xmlDoc.documentElement
   Set newAtt = xmlDoc.createAttribute("ID")
   Set namedNodeMap = root.Attributes
   namedNodeMap.setNamedItem newAtt
   For i = 0 To (namedNodeMap.length - 1)
      MsgBox (namedNodeMap.Item(i).xml)
   Next
End If

C/C++ Syntax

HRESULT createAttribute(
    BSTR name,
    IXMLDOMAttribute **attribute);

Parameters

name [in]

The name of the new attribute object. This name is subsequently available as the new node's nodeName property.

attribute [out, retval]

The address of the new IXMLDOMAttribute object.

C/C++ Return Values

S_OK

The value returned if successful.

E_INVALIDARG

The value returned if the attribute parameter is Null.

E_FAIL

The value returned if an error occurs.