Compartilhar via


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 null 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 envolvendo outra exceção.

Uma exceção de E/S específica de Java, possivelmente o resultado da criação de um novo InputStream ou Reader 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 entidades de parâmetros externos referenciadas no DTD (em ambos os casos, somente se o analisador ler entidades de parâmetros externos) e entidades gerais externas referenciadas no elemento do documento (se o analisador ler entidades gerais externas). O aplicativo pode solicitar que o analisador localize a própria entidade, que use um URI alternativo ou que use dados fornecidos pelo aplicativo (como um fluxo de entrada de caractere ou byte).

Os criadores de aplicativos podem usar esse método para redirecionar identificadores de sistema externos para URIs seguros e/ou locais, para procurar identificadores públicos em um catálogo ou para 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, 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 totalmente antes de relatá-lo ao aplicativo.

Documentação Java 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 usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.

Aplica-se a

Confira também