RemoveChildren Method

Removes the children of the elment as the specified XPath.

procedure RemoveChildren();

Remarks

This method removes the children of the element specified by XPath.

When called the component will remove the children of the element from the internal representation of the XML (the DOM). The element itself remains, with no children. This may be used at any time after Parse returns, or from within the EndElement event as a document is parsed in order to remove sections of a document that will not be needed later. By removing unnecessary elements from the DOM memory consumption is reduced and overall performance is improved.

RemoveChildren Example:

Given the XML

<food>
	<fruits>
		<apple>
			<color>red</color>
		</apple>
		<banana>
			<color>yellow</color>
		</banana>
	</fruits>
</food>

This code removes the children of the apple element while leaving the apple element in place.


xml.XPath = "/food/fruits/apple";
xml.RemoveChildren(); 

The XML stored in the DOM is now:

<food>
	<fruits>
		<apple>
		</apple>
		<banana>
			<color>yellow</color>
		</banana>
	</fruits>
</food>

Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks 2020 Delphi Edition - Version 20.0 [Build 8307]