Idioma

IEntityResolver.ResolveEntity(String, String) Método

Definição

Permitir que o aplicativo resolva entidades externas.

[Android.Runtime.Register("resolveEntity", "(Ljava/lang/String;Ljava/lang/String;)Lorg/xml/sax/InputSource;", "GetResolveEntity_Ljava_lang_String_Ljava_lang_String_Handler:Org.Xml.Sax.IEntityResolverInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Org.Xml.Sax.InputSource? ResolveEntity(string? publicId, string? systemId);
[<Android.Runtime.Register("resolveEntity", "(Ljava/lang/String;Ljava/lang/String;)Lorg/xml/sax/InputSource;", "GetResolveEntity_Ljava_lang_String_Ljava_lang_String_Handler:Org.Xml.Sax.IEntityResolverInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member ResolveEntity : string * string -> Org.Xml.Sax.InputSource

Parâmetros

publicId
String

O identificador público da entidade externa que está sendo referenciada ou nulo se nenhum foi fornecido.

systemId
String

O identificador do sistema da entidade externa que está sendo referenciada.

Retornos

Um objeto InputSource que descreve a nova fonte de entrada ou nulo para solicitar que o analisador abra uma conexão de URI regular com o identificador do sistema.

Atributos

Exceções

Qualquer exceção SAX, possivelmente encapsulando outra exceção.

Uma exceção de E/S específica Java, possivelmente o resultado da criação de um novo InputStream ou Leitor para o InputSource.

Comentários

Permitir que o aplicativo resolva entidades externas.

O analisador chamará esse método antes de abrir qualquer entidade externa, exceto a entidade de documento de nível superior. Essas entidades incluem o subconjunto DTD externo e as entidades de parâmetro externo referenciadas no DTD (em ambos os casos, somente se o analisador ler entidades de parâmetro externo) e entidades gerais externas referenciadas dentro do elemento do documento (se o analisador ler entidades gerais externas). O aplicativo pode solicitar que o analisador localize a entidade em si, que use um URI alternativo ou que use dados fornecidos pelo aplicativo (como um fluxo de entrada de caracteres ou bytes).

Os gravadores de aplicativos podem usar esse método para redirecionar identificadores externos do sistema para proteger e/ou URIs locais, pesquisar identificadores públicos em um catálogo ou ler uma entidade de um banco de dados ou outra fonte de entrada (incluindo, por exemplo, uma caixa de diálogo). Nem XML nem SAX especificam uma política preferencial para usar IDs públicas ou do sistema para resolver recursos. No entanto, o SAX especifica como interpretar qualquer InputSource retornado por esse método e que, se nenhum for retornado, a ID do sistema será desreferenciada como uma URL.

Se o identificador do sistema for uma URL, o analisador SAX deverá resolvê-lo completamente antes de reportá-lo ao aplicativo.

Java documentação para org.xml.sax.EntityResolver.resolveEntity(java.lang.String, java.lang.String).

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

Aplica-se a

Confira também