Try OpenEdge Now
skip to main content
ABL Reference
Handle Attributes and Methods Reference : APPEND-CHILD( ) method
 

APPEND-CHILD( ) method

Appends a node as the last child node of this XML document or element node. Connects a node into the document structure after the node has been created with the CREATE-NODE( ) or CREATE-NODE-NAMESPACE( ) method, cloned with the CLONE-NODE( ) method, or disconnected with the REMOVE-NODE( ) method. This has no effect on the node reference.
If the node is already in the tree, it is disconnected from its present location and then connected at the specified location.
Return type: LOGICAL
Applies to: X-document object handle, X-noderef object handle

Syntax

APPEND-CHILD ( x-node-handle )
x-node-handle
The handle that represents the node to append to this XML document or element node. x-node-handle must refer to a node in this document. You cannot use APPEND-CHILD( ) to move a node from one document to another.
The following code fragment demonstrates creating a node in a tree with the name and value of a field:
. . .
hDoc:CREATE-NODE(hNoderef, bufField:NAME, "ELEMENT").
hNoderefParent:APPEND-CHILD(hNoderef).
hDoc:CREATE-NODE(hText, "", "TEXT").
hText:NODE-VALUE = STRING(bufField:BUFFER-VALUE).
hNoderef:APPEND-CHILD(hText).
. . .