| Microsoft XML Core Services (MSXML) 5.0 for Microsoft Office - SAX2 Reference |  |
ISAXDTDHandler Interface
The ISAXDTDHandler/IVBSAXDTDHandler interface receives notification of basic document type definition (DTD)-related events.
Methods
| 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 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.
Remarks
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.
Versioning
MSXML 3.0 and later
Requirements
Implementation: msxml5.dll
Header and LIB files: msxml2.h, msxml2.lib
To view reference information for Visual Basic or C/C++ only, click the Language Filter button 
in the upper-left corner of the page.
See Also
dtdHandler Property (Visual Basic) | putDTDHandler Method (C/C++) | startDocument Method | startElement Method