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.

Note: The WRITE-FRAGMENT( ) method allows some non-printing characters to be written to XML documents. These characters (for example, #x1, #x1F) are not part of the XML Version 1.0 standard, but are allowed in order to support ABL applications.