LOAD( ) method (Handle)

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). . . .

See also:

ADD-SCHEMA-LOCATION( ) method, NONAMESPACE-SCHEMA-LOCATION attribute, SCHEMA-LOCATION attribute, SCHEMA-PATH attribute