ISAXXMLReader

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

The XML SAX feature for Windows Embedded CE operating system (OS) provides two co-classes that implement the XML Reader interface.

• SAXXMLReader
  The version-independent co-class. Uses the most current implementation. (CLSID_SAXXMLReader: 079aa557-4a18-424a-8eee-e39f0a8d41b9)
• SAXXMLReader30
  The version-dependent co-class. Ties the application to msxml3.dll. (CLSID_SAXXMLReader30: 3124c396-fb13-4836-a6ad-1317f1713688)

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 implementation of Simple API for XML (SAX2) in C++, the reader can use the following methods to register the corresponding handlers.

Method	Description
ISAXXMLReader::putContentHandler Method	Registers a content handler.
ISAXXMLReader::putDTDHandler Method	Registers a DTD handler.
ISAXXMLReader::putErrorHandler Method	Registers an error handler.

Controlling Reader Behavior

You can use the following methods to observe and control the behavior of the reader.

Method	Description
ISAXXMLReader::getFeature Method	Allows an application to ask the reader if it supports a feature.
ISAXXMLReader::putFeature Method	Allows an application to request that the reader turn a particular feature on or off.

Supported Features and Properties

The Microsoft COM/C++ implementation of SAX2 supports the following features, for example, a property whose value is Boolean:

• "https://xml.org/sax/features/namespaces"
• "https://xml.org/sax/features/namespace-prefixes"
• "https://xml.org/sax/features/external-general-entitities"
• "https://xml.org/sax/features/external-parameter-entities"
• "normalize-line-breaks"
• "server-http-request"

The reader also provides the ISAXXMLReader::getProperty Method and ISAXXMLReader::putProperty Method methods for getting and putting these properties.

• "https://xml.org/sax/properties/lexical-handler"
• "https://xml.org/sax/properties/declaration-handler"
• "xmldecl-encoding"
• "xmldecl-version"
• "xmldecl-standalone"

Method	Description
ISAXXMLReader::getBaseURL Method	Returns the base URL for the document.
ISAXXMLReader::putBaseURL Method	Sets the base URL for the document.
ISAXXMLReader::getContentHandler Method	Returns the current content handler.
ISAXXMLReader::putContentHandler Method	Allows an application to register a content handler.
ISAXXMLReader::getDTDHandler Method	Returns the current DTD handler.
ISAXXMLReader::putDTDHandler Method	Allows an application to register a DTD handler.
ISAXXMLReader::getEntityResolver Method	Returns the current entity resolver. At this time, the EntityResolver property cannot be set for this implementation of SAX2 (Simple API for XML).
ISAXXMLReader::putEntityResolver Method	Allows an application to register an entity resolver. At this time, the EntityResolver property cannot be set for this implementation of SAX2 (Simple API for XML).
ISAXXMLReader::getErrorHandler Method	Returns the current error handler.
ISAXXMLReader::putErrorHandler Method	Allows an application to register an error handler.
ISAXXMLReader::getFeature Method	Returns the Boolean value of a feature.
ISAXXMLReader::putFeature Method	Sets the value of a feature.
ISAXXMLReader::getProperty Method	Returns the value of a property. (Currently no properties are supported.)
ISAXXMLReader::putProperty Method	Sets the value of a property.
ISAXXMLReader::getSecureBaseURL Method	Returns the secure base URL for the document.
ISAXXMLReader::putSecureBaseURL Method	Sets the secure base URL for the document.
ISAXXMLReader::parse Method	Parses an XML document.
ISAXXMLReader::parseURL Method	Parses an XML document from a system identifier.

Requirements

Header	msxml2.h, msxml2.idl
Library	uuid.lib
Windows Embedded CE	Windows CE .NET 4.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

XML SAX Interfaces