Export (0) Print
Expand All
DOM
Expand Minimize
This topic has not yet been rated - Rate this topic

removeQualifiedItem Method

Removes the attribute with the specified namespace and attribute name.

var objXMLDOMNode = oXMLDOMNamedNodeMap.removeQualifiedItem(baseName, 
    namespaceURI);

Parameters

baseName

The string specifying the base name of the attribute, without namespace qualification.

namespaceURI

The string specifying the namespace prefix that qualifies the attribute name.

Return Value

An object. Returns the attribute node removed, or Null if no node was removed.

Example

NoteNote

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

var xmlDoc = new ActiveXObject("Msxml2.DOMDocument.3.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.attributes.removeQualifiedItem("id", "");
   WScript.Echo(nodeBook.attributes.length);
}


Ouput

1
0
HRESULT removeQualifiedItem(
    BSTR baseName,
    BSTR namespaceURI,
    IXMLDOMNode **qualifiedItem);

Parameters

baseName[in]

The base name of the attribute, without namespace qualification.

namespaceURI[in]

The namespace prefix that qualifies the attribute name.

qualifiedItem[out, retval]

The attribute node removed, or Null if no node was removed.

Return Values

S_OK

The value returned if successful.

S_FALSE

The value when returning Null.

E_FAIL

The value returned if an error occurs.

Example

IXMLDOMNode *pIXMLDOMNode = NULL;
IXMLDOMNamedNodeMap *pIXMLDOMNamedNodeMap = NULL;
BSTR bstrAttributeName = ::SysAllocString(_T("dateModified"));
IXMLDOMElement *pIXMLDOMElement = NULL;
VARIANT varValue;
HRESULT hr;
IXMLDOMDocument *pIXMLDOMDocument = NULL;

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

    if(pIXMLDOMElement)
    {
        hr = pIXMLDOMElement->get_attributes(&pIXMLDOMNamedNodeMap);
        if(SUCCEEDED(hr) && pIXMLDOMNamedNodeMap)
        {
            hr = pIXMLDOMNamedNodeMap->removeQualifiedItem(bstrAttributeName, NULL,
             &pIXMLDOMNode);
            if(SUCCEEDED(hr) && pIXMLDOMNode)
            {
                pIXMLDOMNode->get_nodeValue(&varValue);
                ::MessageBox(NULL, _bstr_t(varValue), _T("Removed Item"), MB_OK);
                pIXMLDOMNode->Release();
                pIXMLDOMNode = NULL;
            }
            pIXMLDOMNamedNodeMap->Release();
            pIXMLDOMNamedNodeMap = NULL;
        }
        pIXMLDOMElement->Release();
        pIXMLDOMElement = NULL;
    }
    ::SysFreeString(bstrAttributeName);
    bstrAttributeName = NULL;
}
catch(...)
{
    if(bstrAttributeName)
        ::SysFreeString(bstrAttributeName);
    if(pIXMLDOMElement)
        pIXMLDOMElement->Release();
    if(pIXMLDOMNamedNodeMap)
        pIXMLDOMNamedNodeMap->Release();
    if(pIXMLDOMNode)
        pIXMLDOMNode->Release();
    DisplayErrorToUser();
}
// Release pIXMLDOMDocument when finished with it.


This member is an extension of the Worldwide Web Consortium (W3C) Document Object Model (DOM).

Implemented in: MSXML 3.0 and MSXML 6.0

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.