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