Progress
Version 9
Product Update Bulletin


XML-SUPPRESS-NAMESPACE-PROCESSING Attribute

Whether to suppress namespace processing.

Data Type: LOGICAL

Access: Readable/Writeable

Applies To: WEB-CONTEXT Handle

Almost identical to the SUPPRESS-NAMESPACE-PROCESSING attribute of the X-DOCUMENT handle. For more information on SUPPRESS-NAMESPACE-PROCESSING, see the XML-SUPPRESS-NAMESPACE-PROCESSING Attribute reference entry in this book.

What XML-SUPPRESS-NAMESPACE-PROCESSING avoids:

In WebSpeed, the first time you access the X-DOCUMENT handle or any of its attributes, either directly or indirectly, you trigger a load of the document, which precedes your access. For example, if you set the SUPPRESS-NAMESPACE-PROCESSING attribute of X-DOCUMENT (of WEB-CONTEXT) before accessing X-DOCUMENT (of WEB-CONTEXT) or any of its attributes, when the document arrives, WebSpeed first loads the document, then sets SUPPRESS-NAMESPACE-PROCESSING to your value. So at load time, SUPPRESS-NAMESPACE-PROCESSING might not be set to your value, which might cause document validation to fail.

By contrast, if you set XML-SUPPRESS-NAMESPACE-PROCESSING instead of SUPPRESS-NAMESPACE-PROCESSING, when the document arrives, WebSpeed assigns the value of XML-SUPPRESS-NAMESPACE-PROCESSING to SUPPRESS-NAMESPACE-PROCESSING before doing anything else. Even if this triggers a load of the document, SUPPRESS-NAMESPACE-PROCESSING already contains your value, so WebSpeed is able to validate your document.

How to use XML-SUPPRESS-NAMESPACE-PROCESSING:

In WebSpeed, instead of accessing SUPPRESS-NAMESPACE-PROCESSING of X-DOCUMENT (of WEB-CONTEXT), access XML-SUPPRESS-NAMESPACE-PROCESSING (of WEB-CONTEXT). For example, if you want a WebSpeed application to turn namespace processing off (perhaps in response to a Web request), instead of having the application assign FALSE to SUPPRESS-NAMESPACE-PROCESSING of X-DOCUMENT (of WEB-CONTEXT) have the application assign FALSE to XML-SUPPRESS-NAMESPACE-PROCESSING (of WEB-CONTEXT).

For more information on accessing XML documents using the SAX and X-DOCUMENT interfaces, see the Progress External Program Interfaces book.


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095