ISAXXMLReader Interface

 

The ISAXXMLReader/IVBSAXXMLReader interface allows an application to set and query features and properties in Microsoft® XML Core Services (MSXML), register event handling for document processing, and initiate a document parse.

With MSXML 3.0 and MSXXML 6.0, version-dependent CoClasses are provided that implement this interface. For more information on each version-specific CoClass, refer to the version-specific GUID and Prog ID reference topics in the GUIDs and ProgID Information section.

With MSXML 6.0, you can throw SAX events from a DOMDocument object by specifying the DOMDocument object as the input parameter for the parse method. For more information, see Convert DOM to SAX.

Properties

baseURL Sets the base URL for the current document.
contentHandler Sets the current ContentHandler.
dtdHandler Sets the current DTDHandler.
entityResolver Sets the current EntityResolver.
errorHandler Registers or returns the current ErrorHandler.
secureBaseURL Sets the secure base URL for the document.

Methods

getFeature Returns the Boolean value of a feature. Allows an application to ask the reader if it supports a feature.
putFeature Sets the value of a feature. Allows an application to request that the reader turn a feature on or off.
getProperty Returns the value of a property (as a string), for any qualified Uniform Resource Identifier (URI). Allows an application to ask the reader the value of one its properties.
putProperty Sets the value of a property. Allows an application to set a property of the SAX reader.
parse Parses an XML document or a DOMDocument object.
parseURL Parses an XML document from a system identifier.

The IVBSAXXMLReader interface is implemented in the Simple API for XML (SAX2) applications to manage and execute the parsing of an XML document.

Controlling Reader Behavior

The Microsoft COM/Visual Basic® implementation of SAX2 supports a number of features and properties. To observe and control features of the SAX reader, you use the getFeature annd putFeature methods. Likewise, to read or set properties of the SAX reader, you use the getProperty and putProperty methods.

For more information, see SAX Reader Features and SAX Reader Properties.

Note

The reader recognizes the "http://xml.org/sax/features/string-interning" and "schema-validation" features. However, you cannot set these features in the current SAX2 implementation.

Creating an Instance of the Reader

Typically, you create an instance of the reader in the Main form of a Visual Basic application. For example, first you declare a variable for holding a reference to the IVBSAXXMLReader interface. You then create a version-specific instance of the reader (in this example, MSXML 6.0) and assign the interface to the object variable as follows:

Dim reader As SAXXMLReader60
Set reader = New SAXXMLReader60

Creating an Instance of a Handler

After you create an instance of the reader, you can create an instance of a ContentHandler or ErrorHandler, and then set them as properties of the reader object using the contentHandler and errorHandler properties.

Registering Handlers

An application can set and query features in the reader, register event handlers for document processing, and initiate a document parse. With this COM/C++ implementation of SAX2, the reader can use the following methods to register the corresponding handlers:

putContentHandler
Registers a ContentHandler.

putDTDHandler
Registers a DTDHandler.

putErrorHandler
Registers an ErrorHandler.

Methods

In addition to the preceding methods, the following also apply to the ISAXXMLReader interface.

getBaseURL Returns the base URL for the document.
putBaseURL Sets the base URL for the document.
getContentHandler Returns the current ContentHandler.
putContentHandler Allows an application to register a ContentHandler.
getDTDHandler Returns the current DTDHandler.
putDTDHandler Allows an application to register a DTDHandler.
getEntityResolver Returns the current EntityResolver.
putEntityResolver Allows an application to register an EntityResolver.
getErrorHandler Returns the current ErrorHandler.
putErrorHandler Allows an application to register an ErrorHandler.
getSecureBaseURL Returns the secure base URL for the document.
putSecureBaseURL Sets the secure base URL for the document.

Requirements

Implementation:

msxml3.dll, msxml2.lib (MSXML 3.0)

msxml6.dll, msxml6.lib (MSXML 6.0)

Header and LIB files: msxml2.h, msxml2.lib , msxml6.h, msxml6.lib

Versioning

Implemented in: MSXML 3.0 and later