ILexicalHandler.StartEntity(String) Metodo

Definizione

Spazio dei nomi:
Org.Xml.Sax.Ext
Assembly:
Mono.Android.dll

Segnalare l'inizio di alcune entità XML interne ed esterne.

[Android.Runtime.Register("startEntity", "(Ljava/lang/String;)V", "GetStartEntity_Ljava_lang_String_Handler:Org.Xml.Sax.Ext.ILexicalHandlerInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public void StartEntity(string? name);
[<Android.Runtime.Register("startEntity", "(Ljava/lang/String;)V", "GetStartEntity_Ljava_lang_String_Handler:Org.Xml.Sax.Ext.ILexicalHandlerInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member StartEntity : string -> unit

Parametri

name
String

Nome dell'entità. Se si tratta di un'entità parametro, il nome inizierà con '%', e se è il subset DTD esterno, sarà "[dtd]".

Attributi
RegisterAttribute

Eccezioni

SAXException

L'applicazione può generare un'eccezione.

Commenti

Segnalare l'inizio di alcune entità XML interne ed esterne.

La segnalazione di entità di parametro (incluso il subset DTD esterno) è facoltativa e i driver SAX2 che segnalano eventi LexicalHandler potrebbero non implementarlo; è possibile usare la http://xml.org/sax/features/lexical-handler/parameter-entities funzionalità per eseguire query o controllare la segnalazione delle entità dei parametri.

Le entità generali vengono segnalate con i nomi regolari, le entità di parametro hanno '%' anteporte ai nomi e il sottoinsieme DTD esterno ha il nome di pseudoentità "[dtd]".

Quando un driver SAX2 fornisce questi eventi, tutti gli altri eventi devono essere annidati correttamente all'interno di eventi di entità iniziale/finale. Non esiste alcun requisito aggiuntivo che gli eventi di org.xml.sax.ext.DeclHandler DeclHandler o org.xml.sax.DTDHandler DTDHandler siano ordinati correttamente.

Si noti che le entità ignorate verranno segnalate tramite l'evento org.xml.sax.ContentHandler#skippedEntity skippedEntity , che fa parte dell'interfaccia ContentHandler.

A causa del modello di eventi di streaming usato da SAX, non è possibile segnalare alcuni limiti di entità in alcuna circostanza:

<ul><li>general entities within attribute values</li><>parameter entities within declarations</li></ul>

Questi verranno espansi automaticamente, senza alcuna indicazione della posizione dei limiti dell'entità originale.

Si noti anche che i limiti dei riferimenti a caratteri (che non sono effettivamente entità comunque) non vengono segnalati.

Tutti gli eventi start/endEntity devono essere annidati correttamente.

per org.xml.sax.ext.LexicalHandler.startEntity(java.lang.String).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.

Si applica a

Vedi anche

  • EndEntity(String)
  • <xref:Org.Xml.Sax.Ext.IDeclHandler.InternalEntityDecl(System.String%2c+System.String)>
  • <xref:Org.Xml.Sax.Ext.IDeclHandler.ExternalEntityDecl(System.String%2c+System.String%2c+System.String)>