WRITE-FRAGMENT( ) method

Adds character data to the XML document represented by a SAX-writer object.

Return type:

LOGICAL

Applies to:

SAX-writer object handle

 

Syntax 

WRITE-FRAGMENT ( { chardata | longchar | x-noderef } )

chardata

An expression that evaluates to a CHARACTER variable that contains the XML text.

longchar

An expression that evaluates to a LONGCHAR variable that contains the XML text.

noderef

A valid X-NODEREF handle that contains the XML text.

Call this method to add un-escaped CHARACTER data to the XML document. This allows the adding of XML fragments to the document without the special characters being escaped to their XML representation. For example, "<" escapes to &lt;. It is up to the developer to ensure that the characters written are proper XML with the correct characters escaped. Even if the STRICT attribute is TRUE, the SAX-writer will not validate what is written.

You can call this method at any time during the write. This method changes the WRITE-STATUS attribute to SAX-WRITE-CONTENT.