skippedEntity Method

 

Receives notification of a skipped entity. The skippedEntity method is invoked for each entity skipped. The reader may skip entities if they have not been seen in the declarations. An example of this is when an entity is declared in an external DTD subset. The reader may skip external entities, depending on the values of the "http://xml.org/sax/features/external-general-entities" and "http://xml.org/sax/features/external-parameter-entities" features.

The skippedEntity method is also called in the case of an external DTD declaration. For example:

<!DOCTYPE xyz SYSTEM "http://...">

Visual Basic Implementation Syntax

Sub skippedEntity(strName As String)  

Parameters

strName
The name of the skipped entity. If the entity is a parameter entity, the name begins with '%'.

Return Values

If failed, the ContentHandler raises a trappable error.

C/C++ Syntax

HRESULT skippedEntity(  
   [in] const wchar_t * pwchName,  
   [in] int cchName);  

Parameters

pwchName[in]
The name of the skipped entity. If the entity is a parameter entity, the name begins with '%'.

cchName[in]
The number of characters in the pwchName string.

Return Values

S_OK
The value returned if no errors occur.

E_FAIL
The value returned if the parse operation should be aborted.

Versioning

Implemented in: MSXML 3.0 and later

Applies to

ISAXContentHandler Interface

See Also

putFeature Method