IEntityResolver.ResolveEntity(String, String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.