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