Loads a XML Document into a DomDocument object from a string.


   xmlstr STRING )
  1. xmlstr defines the string to load.


Use this method to load a XML Document into a DomDocument object from a string, where xmlstr is the string to load.

Important: This method is not part of W3C standard API.

Use setFeature() to specify how the document can be loaded. HTML parsing is possible when enable-html-compliancy is enabled.

See getErrorsCount() and getErrorDescription() to retrieve error messages related to XML document.

Note: When loading a document, if xml.DomNode objects are still referenced in other variables of the program, the entire document is kept in memory. Otherwise, the DOM nodes of the document are deleted before loading the new document. For more details about object references and garbage collection in BDL, see Working with objects.

In case of error, the method throws an exception and sets the STATUS variable. Depending on the error, a human-readable description of the problem is available in the SQLCA.SQLERRM register. See Error handling in GWS calls (STATUS).