CREATE X-DOCUMENT statement

Creates a handle for an XML document object. To use the XML document, you must add new nodes using the CREATE-NODE( ) method, the CREATE-NODE-NAMESPACE( ) method, or populate the document from an existing file using the LOAD( ) method.

Note:

To ensure consistency across all nodes in an XML document, use either the CREATE-NODE-NAMESPACE( ) method or the CREATE-NODE( ) method to build an XML document; do not use both methods within a single document.

Syntax 

 

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

handle

A variable of type HANDLE into which CREATE X-DOCUMENT stores the new handle.

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 document object.

Note:

Widget pool names are not case‑sensitive.

Example 

The following code fragment depicts creating an XML document object:

 

DEFINE VARIABLE hXdoc AS HANDLE NO-UNDO. . . . CREATE X-DOCUMENT hXdoc. . . .

See also 

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