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 (X-noderef):

 

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