ILexicalHandler.StartEntity(String) Methode

Definition

Namespace:
Org.Xml.Sax.Ext
Assembly:
Mono.Android.dll

Melden Sie den Anfang einiger interner und externer XML-Entitäten.

[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

Parameter

name
String

Der Name der Entität. Wenn es sich um eine Parameterentität handelt, beginnt der Name mit '%', und wenn es sich um die externe DTD-Teilmenge handelt, lautet er "[dtd]".

Attribute
RegisterAttribute

Ausnahmen

SAXException

Die Anwendung kann eine Ausnahme auslösen.

Hinweise

Melden Sie den Anfang einiger interner und externer XML-Entitäten.

Die Berichterstellung von Parameterentitäten (einschließlich der externen DTD-Teilmenge) ist optional, und SAX2-Treiber, die LexicalHandler-Ereignisse melden, können sie nicht implementieren; Sie können das http://xml.org/sax/features/lexical-handler/parameter-entities Feature verwenden, um die Berichterstellung von Parameterentitäten abzufragen oder zu steuern.

Allgemeine Entitäten werden mit ihren regulären Namen gemeldet, Parameterentitäten haben '%' vor ihren Namen, und die externe DTD-Teilmenge hat den Pseudoentitätsnamen "[dtd]".

Wenn ein SAX2-Treiber diese Ereignisse bereitstellt, müssen alle anderen Ereignisse ordnungsgemäß in Start-/End-Entitätsereignissen geschachtelt werden. Es gibt keine zusätzliche Anforderung, dass Ereignisse von org.xml.sax.ext.DeclHandler DeclHandler oder org.xml.sax.DTDHandler DTDHandler ordnungsgemäß sortiert werden.

Beachten Sie, dass übersprungene Entitäten über das org.xml.sax.ContentHandler#skippedEntity skippedEntity Ereignis gemeldet werden, das Teil der ContentHandler-Schnittstelle ist.

Aufgrund des streamingereignismodells, das SAX verwendet, können unter keinen Umständen einige Entitätsgrenzen gemeldet werden:

<ul><li>allgemeine Entitäten innerhalb von Attributwerten</li li-Parameterentitäten><>innerhalb von Deklarationen</li></ul>

Diese werden im Hintergrund erweitert, ohne dass angegeben wird, wo die ursprünglichen Entitätsgrenzen liegen.

Beachten Sie auch, dass die Grenzen von Zeichenbezügen (die nicht wirklich Entitäten sind) nicht gemeldet werden.

Alle Start-/EndEntity-Ereignisse müssen ordnungsgemäß geschachtelt sein.

Java Dokumentation für org.xml.sax.ext.LexicalHandler.startEntity(java.lang.String).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

Weitere Informationen

  • 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)>