removeAttribute Method

 

Removes or replaces the named attribute.

JScript Syntax

oXMLDOMElement.removeAttribute(name);  

Parameters

name
A string specifying the name of the attribute to be removed or replaced.

Example

Note

You can use books.xml to run this sample code.

var xmlDoc = new ActiveXObject("Msxml2.DOMDocument.6.0");
var nodeBook;
xmlDoc.setProperty("SelectionLanguage", "XPath");
xmlDoc.async = false;
xmlDoc.load("books.xml");
if (xmlDoc.parseError.errorCode != 0) {
   var myErr = xmlDoc.parseError;
   WScript.Echo("You have error " + myErr.reason);
} else {
   nodeBook = xmlDoc.selectSingleNode("//book");
   WScript.Echo(nodeBook.attributes.length);
   nodeBook.removeAttribute("id");
   WScript.Echo(nodeBook.attributes.length);
}

Output

1  
0  

C/C++ Syntax

HRESULT removeAttribute(  
    BSTR name);  

Parameters

name[in]
The name of the attribute to be removed or replaced.

Return Values

S_OK
The value returned if successful.

S_FALSE
The value returned when no attribute with the given name is found.

E_FAIL
The value returned if an error occurs.

Example

IXMLDOMElement *pIXMLDOMElement = NULL;
_bstr_t bstrAttributeName = _T("dateCreated");
IXMLDOMDocument *pIXMLDOMDocument = NULL;
HRESULT hr;

try
{
   // Create an instance of DOMDocument and initialize pIXMLDOMDocument.
   // Load/create an XML fragment.
   hr = pIXMLDOMDocument->get_documentElement(&pIXMLDOMElement);
   SUCCEEDED(hr) ? 0 : throw hr;

   hr = pIXMLDOMElement->removeAttribute(bstrAttributeName);
   if(SUCCEEDED(hr))
   {
   // Attribute removed.
   }
   pIXMLDOMElement->Release();
   pIXMLDOMElement = NULL;
   // Release pIXMLDOMDocument when finished with it.
}
catch(...)
{
   // Release pIXMLDOMDocument if it exists.
   if(pIXMLDOMElement)
      pIXMLDOMElement->Release();
   DisplayErrorToUser();
}

Remarks

If the specified attribute has a default value, this is equivalent to a replace operation: The current value is removed and a new attribute is created with the default value. This operation also resets the specified property of IXMLDOMNode.

Versioning

Implemented in: MSXML 3.0 and MSXML 6.0

See Also

specified Property
IXMLDOMElement