CREATE X-NODEREF statement

CREATE X-NODEREF statement

Creates a handle which can be used as a parameter or return-value for methods which will associate the handle with an XML node. This object is not a node in its own right, but merely a way to provide access to the underlying XML node.

Syntax
CREATE X-NODEREF handle [ IN WIDGET-POOL widget-pool-name ] 
handle

A valid X-noderef object handle to use for the new XML node.

IN WIDGET-POOL widget-pool-name

An expression of type CHARACTER that evaluates, at run time, to the name of the widget pool that contains the XML node.

Note: Widget pool names are not case-sensitive.

An X-noderef object is not in a fully usable state until it has been associated with an X-document. Before this, you can only access its HANDLE, TYPE, PRIVATE-DATE, and UNIQUE-ID attributes without error. To avoid run-time errors, the code below shows one way to test the status of an X-noderef object:
cType = X-noderef:SUBTYPE NO-ERROR. 
IF VALID-HANDLE(X-noderef) AND cType = 'ELEMENT' THEN DO: 
   /*** your code ***/ 
END. 
Example

The following code fragment depicts creating an XML document node reference and using it to create a node:
DEFINE VARIABLE hXdoc AS HANDLE NO-UNDO. 
. . . 
CREATE X-DOCUMENT hXdoc. 
CREATE X-NODEREF hXnode. 
hXdoc:CREATE-NODE(hXnode,"City","ELEMENT"). 
. . . 
See also

CREATE X-DOCUMENT statement, DELETE OBJECT statement, X-document object handle, X-noderef object handle

CREATE X-NODEREF `handle` [ IN WIDGET-POOL `widget-pool-name` ]

cType = `X-noderef`:SUBTYPE NO-ERROR. IF VALID-HANDLE(`X-noderef`) AND cType = 'ELEMENT' THEN DO: /* your code */ END.

DEFINE VARIABLE hXdoc AS HANDLE NO-UNDO. . . . CREATE X-DOCUMENT hXdoc. CREATE X-NODEREF hXnode. hXdoc:CREATE-NODE(hXnode,"City","ELEMENT"). . . .

OpenEdge Release 10.2B