createAttribute Method

Creates a new attribute with the specified name.

Syntax

objDOMAttribute = oDOMDocument.createAttribute(name)

Parameters

name

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

Returns

Object. Returns the new IDOMAttribute object.

Remarks

No data value is set for the attribute during the create operation. You can set the value by calling the element object's setAttribute method.

Although this method creates the new object in the context of this document, this method does not automatically add the new object to the document tree. In other words, although the ownerDocument property of the new node points to this document object, the parentNode property is set to NULL. To associate the attribute with an element, call the IDOMElement object's setAttribute method.

Note that you cannot specify a namespace within the name parameter. If the name is specified in the form "xxx:yyy", the special meaning of the colon is ignored and the attribute is created in the namespace of the document with the base name "xxx:yyy" and no namespace prefix. The nameSpace property, which contains the namespace URI (universal resource identifier), is set to the empty string, "".

The nodeType has the value NODE_ATTRIBUTE.

Applies To

IDOMDocument, IXMLDOMDocument

Does this content meet your programming needs? Write us!

Back to top