ILexicalHandler.StartEntity(String) Método

Definición

Espacio de nombres:: Org.Xml.Sax.Ext

Ensamblado:: Mono.Android.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Informe del principio de algunas entidades XML internas y externas.

[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

Parámetros

name: String

El nombre de la entidad. Si es una entidad de parámetro, el nombre comenzará por "%" y, si es el subconjunto de DTD externo, será "[dtd]".

Atributos: RegisterAttribute

Excepciones

SAXException

La aplicación puede generar una excepción.

Comentarios

Informe del principio de algunas entidades XML internas y externas.

La generación de informes de entidades de parámetros (incluido el subconjunto DTD externo) es opcional y los controladores SAX2 que informan de eventos LexicalHandler pueden no implementarlo; Puede usar la http://xml.org/sax/features/lexical-handler/parameter-entities característica para consultar o controlar los informes de entidades de parámetros.

Las entidades generales se notifican con sus nombres normales, las entidades de parámetro tienen "%" antepuestos a sus nombres y el subconjunto de DTD externo tiene el nombre de pseudo-entidad "[dtd]".

Cuando un controlador SAX2 proporciona estos eventos, todos los demás eventos deben anidarse correctamente dentro de los eventos de entidad start/end. No hay ningún requisito adicional de que los eventos de org.xml.sax.ext.DeclHandler DeclHandler o org.xml.sax.DTDHandler DTDHandler se ordenen correctamente.

Tenga en cuenta que las entidades omitidas se notificarán a través del org.xml.sax.ContentHandler#skippedEntity skippedEntity evento , que forma parte de la interfaz ContentHandler.

Debido al modelo de eventos de streaming que usa SAX, algunos límites de entidad no se pueden notificar en ninguna circunstancia:

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

Estos se expandirán silenciosamente, sin indicar dónde estaban los límites de la entidad original.

Tenga en cuenta también que no se notifican los límites de las referencias de caracteres (que no son realmente entidades).

Todos los eventos start/endEntity deben estar anidados correctamente.

Java documentación para org.xml.sax.ext.LexicalHandler.startEntity(java.lang.String).

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Se aplica a

Consulte también

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