XML DOM

XML DOM Contents

The DOM Method: removeAttribute()

The DOM Method: nodeFromID()

The DOM Method: nextNode()

The DOM Method: loadXML()

The DOM Method: load()

The DOM Method: insertBefore()

The DOM Method: hasChildNodes()

The DOM Method: getNamedItem()

The DOM Method: getElementsByTagName()

The DOM Method: getAttributeNode()

The DOM Method: getAttribute()

The DOM Method: createNode()

The DOM Method: Create - other examples

The DOM Method: cloneNode()

The DOM Method: appendChild()

The DOM Method: abort()

The DOM Method: DOM object methods

The Node Type: NODE_TEXT

The Node Type: NODE_PROCESSING_INSTRUCTION

<< XHTML			XmlSerializer >>

By :	Mark Wilson I am the creator of TopXML. I am available for international and local (Australia) contracts. I am a Solution Architect/Business Analyst. I have worked in IT in several countries (NZ, Australia, South Africa, UK) building and training teams for government and very large non-governmental organizations. I am ex-Microsoft Consulting Services. I wrote the first book on Microsoft XML published in 2000 called XML Programming with VB and ASP. Most recently I have been building tools for the SEO industry. Ask me for a 37 point SEO health-checkup for your website.
First posted :	03/24/2008
Times viewed :	2843

removeChild()

Is a member of:

DOMDocument
XMLDOMNode
XMLDOMAttribute
XMLDOMCDATASection
XMLDOMComment
XMLDOMDocumentFragment
XMLDOMDocumentType
XMLDOMElement
XMLDOMEntity
XMLDOMEntityReference
XMLDOMNotation
XMLDOMProcessingInstruction
XMLDOMText
XTLRuntime

Syntax

Set objXMLDOMNode = objXMLDOMNode.removeChild(oldChild)

Remark

The parameter oldChild is the Node to be removed from the list of children for this Node. If the removal is successful, this method returns the removed child Node (objXMLDOMNode).

Although this method has been added to most of the DOMDocument interfaces, it cannot actually be used with all of them, as they may not have child Nodes to remove.

This method returns the Node that has just been removed (see the nodeType property for more information on Node types). It works successfully with the following Node types:

¬ Document

¬ Element

¬ Attribute

¬ Document Fragment

¬ Node (if its type is one of the above)

The following types of Nodes cannot have childNodes; therefore, this method cannot be used successfully for the following nodeTypes:

¬ Comment

¬ Text

¬ Processing Instruction

¬ CDATA section

¬ Notation

Although the following can have children, they are childNodes that cannot be removed, as they may be part of a DTD:

¬ Document type

¬ Entity

¬ Entity reference

Example

The following example removes the firstChild of the child Node collection of the documentElement property.

Dim objDOMDocument As DOMDocument

Dim objXMLDOMElement As IXMLDOMElement

Dim objRemovedElement As IXMLDOMElement

Set objDOMDocument = New DOMDocument

objDOMDocument.async = False

objDOMDocument.Load "http://localhost/xmlcode/people2.dtd"

Set objXMLDOMElement = objDOMDocument.documentElement.firstChild

Set objRemovedElement = objDOMDocument.documentElement.removeChild(objXMLDOMElement)

If objRemovedElement Is Nothing Then

' this removal was unsuccessful, show warning

End If

¬ The object objRemovedElement returns the removed Node if the removeChild
execution was successful.

¬ If the removal was unsuccessful, then it returns a warning.

This manuscript is an abridged version of a chapter from the Manning Publications book XML Programming with VB and ASP. This chapter looks at the Microsoft DOM objects. NOTE: Most images have been removed to increase speed and many of the code comments have also been removed for presentation. Please purchase the book to enjoy the full experience of all the chapters with images and code comments!