Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

ISAXDTDHandler Interface

The ISAXDTDHandler/IVBSAXDTDHandler interface receives notification of basic document type definition (DTD)-related events.

notationDecl

Receives notification of a notation declaration event.

unparsedEntityDecl

Receives notification of an unparsed entity declaration event.

If a Simple API for XML (SAX) application requires information about notations and unparsed entities, the application implements this interface and registers an instance with the SAX2 reader using the dtdHandler property. This DTDHandler instance reports notation and unparsed entity declarations to the application.

The IVBSAXDTDHandler interface includes methods that are invoked by the reader during the parsing operation. The reader passes the appropriate information to the method's parameters. To perform some type of processing for a method, you simply add code to the method in the DTDHandler implementation. In general, it's rare that you would call these methods yourself from within the DTDHandler. As such, the syntax shown for the IVBSAXDTDHandler interface focuses on the implementation syntax, rather than usage syntax.

Important note Important

The SAX2 reader passes string values to IVBSAXDTDHandler methods by reference, rather than by value.

If a Simple API for XML (SAX) application requires information about notations and unparsed entities, the application implements this interface and registers an instance with the SAX2 reader using the putDTDHandler method. The instance of the DTDHandler reports notation and unparsed entity declarations to the application.

This interface includes only those DTD events that the XML recommendation requires processors to report: notation and unparsed entity declarations.

The reader can report these events in any order, regardless of the order in which the notations and unparsed entities were declared. However, all DTD events must be reported after the ContentHandler's startDocument event, and before the first startElement event.

It is up to the application to store the information for future use (perhaps in a hash table or object tree). If the application encounters attributes of type NOTATION, ENTITY, or ENTITIES, it can use the information that it obtained through this interface to find the entity or notation corresponding to the attribute value.

Implementation:

msxml3.dll (MSXML 3.0)

msxml6.dll (MSXML 6.0)

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

Implemented in: MSXML 3.0 and later

Show:
© 2015 Microsoft