GET-DOCUMENT-ELEMENT( ) method

GET-DOCUMENT-ELEMENT( ) method

Retrieves the root element of the document. The parameter must be a valid X-noderef handle and will refer to the document’s root element if the method succeeds.

Return type: LOGICAL

Applies to: X-document object handle
Syntax
GET-DOCUMENT-ELEMENT( x-node-handle ) 
x-node-handle

A valid X-noderef handle to use for the root element.

The following example demonstrates the use of GET-DOCUMENT-ELEMENT if hDoc is an X-document and hRoot is an X-noderef:
/* Creates an ABL document object & initializes the associated XML object. */ 
CREATE X-document hDoc. 
/* Creates an ABL reference for an XML node in a parse tree. */ 
CREATE X-NODEREF hRoot. 
/* Reads the myxml.xml document into an XML parse tree. */ 
hDoc:LOAD("file","myxml.xml",false). 
/* Associates hRoot with the root node of the hDoc document. */ 
hDoc:GET-DOCUMENT-ELEMENT(hRoot). 

Syntax
GET-DOCUMENT-ELEMENT( `x-node-handle` )

/* Creates an ABL document object & initializes the associated XML object. / CREATE X-document hDoc. / Creates an ABL reference for an XML node in a parse tree. / CREATE X-NODEREF hRoot. / Reads the myxml.xml document into an XML parse tree. / hDoc:LOAD("file","myxml.xml",false). / Associates hRoot with the root node of the hDoc document. */ hDoc:GET-DOCUMENT-ELEMENT(hRoot).

OpenEdge Release 10.2B