Langue

ILexicalHandler.StartEntity(String) Méthode

Définition

Espace de noms:
Org.Xml.Sax.Ext
Assembly:
Mono.Android.dll

Signalez le début de certaines entités XML internes et externes.

[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

Paramètres

name
String

Le nom de l’entité. S’il s’agit d’une entité de paramètre, le nom commence par «%», et s’il s’agit du sous-ensemble DTD externe, il s’agit de « [dtd] ».

Attributs
RegisterAttribute

Exceptions

SAXException

L’application peut déclencher une exception.

Remarques

Signalez le début de certaines entités XML internes et externes.

La création de rapports d’entités de paramètre (y compris le sous-ensemble DTD externe) est facultative et les pilotes SAX2 qui signalent des événements LexicalHandler peuvent ne pas l’implémenter ; vous pouvez utiliser la http://xml.org/sax/features/lexical-handler/parameter-entities fonctionnalité pour interroger ou contrôler la création de rapports d’entités de paramètres.

Les entités générales sont signalées avec leurs noms réguliers, les entités de paramètre ont «%» ajoutées à leurs noms, et le sous-ensemble DTD externe a le nom pseudo-entité « [dtd] ».

Lorsqu’un pilote SAX2 fournit ces événements, tous les autres événements doivent être correctement imbriqués dans les événements d’entité de début/fin. Il n’existe aucune exigence supplémentaire indiquant que les événements provenant ou org.xml.sax.ext.DeclHandler DeclHandlerorg.xml.sax.DTDHandler DTDHandler sont correctement ordonnés.

Notez que les entités ignorées sont signalées via l’événement org.xml.sax.ContentHandler#skippedEntity skippedEntity , qui fait partie de l’interface ContentHandler.

En raison du modèle d’événement de diffusion en continu que SAX utilise, certaines limites d’entité ne peuvent pas être signalées dans des circonstances :

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

Celles-ci seront développées silencieusement, sans indication de l’emplacement des limites d’entité d’origine.

Notez également que les limites des références de caractères (qui ne sont pas vraiment des entités de toute façon) ne sont pas signalées.

Tous les événements start/endEntity doivent être correctement imbriqués.

Java documentation pour org.xml.sax.ext.LexicalHandler.startEntity(java.lang.String).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

S’applique à

Voir aussi

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