ISAXXMLReader (Compact 2013)

3/26/2014

The XML SAX feature for Windows Embedded Compact 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

See Also

Reference

XML SAX Interfaces