Loads an XML document into memory, parses it,
and makes its contents available in ABL as an X-document object.
This
method sets the ENCODING attribute for the
XML document to the encoding name specified in the XML document's encoding
declaration.
Return type: LOGICAL
Applies
to:
X-document object handle
Syntax
LOAD ( mode , { file|memptr|longchar } , validate )
|
-
mode
- A character expression that evaluates to one of the following:
"FILE", "MEMPTR", or "LONGCHAR".
-
file
- A character expression that represents the name of a file that contains
the source XML text. You can specify a relative pathname, an absolute
pathname, or an HTTP URL. Any relative pathname is relative to the
current working directory. The pathname can contain Unicode characters.
See OpenEdge Development: Internationalizing Applications for
more information about Unicode.
-
memptr
- A MEMPTR variable that contains the source XML text. The size
of the MEMPTR variable should match the size of the XML text.
-
longchar
- A LONGCHAR variable that contains the source XML text. The size of
the LONGCHAR variable should match the size of the XML text.
-
validate
- A logical expression where TRUE indicates that the parser should validate
the document's logical structure with respect to its Document Type
Definition (DTD). Note that even if validation against the DTD is not
specified, the document's physical structure is still validated.
If this expression is TRUE, then the parser will also validate against
any XML Schema file references in the XML document or specified
in the SCHEMA-LOCATION and NONAMESPACE-SCHEMA-LOCATION attribute.
The
following code fragment creates a parse tree of XML nodes and validates
its structure:
DEFINE VARIABLE hDoc AS HANDLE NO-UNDO.
CREATE X-DOCUMENT hDoc.
hDoc:LOAD("file", "memo.xml", TRUE).
. . .
|