RemoveNamedNode - cXMLDOMDocumentFragment

Removes the named node

Type: Function

Return Data Type: Handle

Parameters: String sQueryString

ParameterDescription
sQueryStringNode Name


Return Value

The returned value is the object handle of the node that got removed (assuming the named node was found), or 0 if not.


Syntax
Function RemoveNamedNode String sQueryString Returns Handle

Call: Get RemoveNamedNode sQueryString to HandleVariable


Description

RemoveNamedNode is not namespace aware and only works reliably for elements with no namespaces and no prefixes. You should use RemoveQualifiedNode in its place.


RemoveNamedNode removes the named node.

An object handle is returned, and the object must be disposed of by sending the Destroy message to it. The returned value is the object ID of the node that got removed (assuming the named node was found), or 0 if not.

Note:This function returns an XML node object and, like all XML node objects, it is the responsibility of the developer to destroy them when they are no longer needed. The reason IDs are returned and not automatically destroyed is that it gives you the ability to do something else with the node. You could, for example, take a removed node and add it somewhere else.