Idioma

ILexicalHandler.StartEntity(String) Método

Definição

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

Relatar o início de algumas entidades XML internas e 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

O nome da entidade. Se for uma entidade de parâmetro, o nome começará com '%', e se for o subconjunto DTD externo, será "[dtd]".

Atributos
RegisterAttribute

Exceções

SAXException

O aplicativo pode gerar uma exceção.

Comentários

Relatar o início de algumas entidades XML internas e externas.

O relatório de entidades de parâmetro (incluindo o subconjunto DTD externo) é opcional e os drivers SAX2 que relatam eventos LexicalHandler podem não implementá-lo; você pode usar o http://xml.org/sax/features/lexical-handler/parameter-entities recurso para consultar ou controlar o relatório de entidades de parâmetro.

Entidades gerais são relatadas com seus nomes regulares, entidades de parâmetro têm '%' pré-acrescentados aos seus nomes, e o subconjunto DTD externo tem o nome da pseudo-entidade "[dtd]".

Quando um driver SAX2 está fornecendo esses eventos, todos os outros eventos devem ser aninhados corretamente em eventos de entidade de início/término. Não há nenhum requisito adicional de que os eventos sejam org.xml.sax.ext.DeclHandler DeclHandler ordenados corretamente.org.xml.sax.DTDHandler DTDHandler

Observe que as entidades ignoradas serão relatadas por meio do org.xml.sax.ContentHandler#skippedEntity skippedEntity evento, que faz parte da interface ContentHandler.

Devido ao modelo de evento de streaming que o SAX usa, alguns limites de entidade não podem ser relatados em nenhuma circunstância:

<entidades gerais ul>li dentro de valores de atributo/entidades< de parâmetro li li><>dentro de declarações</li></ul><>

Elas serão silenciosamente expandidas, sem nenhuma indicação de onde estavam os limites de entidade originais.

Observe também que os limites das referências de caractere (que não são realmente entidades de qualquer maneira) não são relatados.

Todos os eventos start/endEntity devem ser aninhados corretamente.

Java documentação para org.xml.sax.ext.LexicalHandler.startEntity(java.lang.String).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Aplica-se a

Confira também

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