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:

  • "http://xml.org/sax/features/namespaces"
  • "http://xml.org/sax/features/namespace-prefixes"
  • "http://xml.org/sax/features/external-general-entitities"
  • "http://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.

  • "http://xml.org/sax/properties/lexical-handler"
  • "http://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