IEntityResolver2.ResolveEntity(String, String, 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.
Permite que os aplicativos mapeiem referências a entidades externas em fontes de entrada ou informem ao analisador que ele deve usar a resolução de URI convencional.
[Android.Runtime.Register("resolveEntity", "(Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;)Lorg/xml/sax/InputSource;", "GetResolveEntity_Ljava_lang_String_Ljava_lang_String_Ljava_lang_String_Ljava_lang_String_Handler:Org.Xml.Sax.Ext.IEntityResolver2Invoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Org.Xml.Sax.InputSource? ResolveEntity(string? name, string? publicId, string? baseURI, string? systemId);[<Android.Runtime.Register("resolveEntity", "(Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;)Lorg/xml/sax/InputSource;", "GetResolveEntity_Ljava_lang_String_Ljava_lang_String_Ljava_lang_String_Ljava_lang_String_Handler:Org.Xml.Sax.Ext.IEntityResolver2Invoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member ResolveEntity : string * string * string * string -> Org.Xml.Sax.InputSourceParâmetros
- name
- String
Identifica a entidade externa que está sendo resolvida. "[dtd]" para o subconjunto externo ou um nome começando com "%" para indicar uma entidade de parâmetro ou então o nome de uma entidade geral. Isso nunca é nulo quando invocado por um analisador SAX2.
- publicId
- String
O identificador público da entidade externa que está sendo referenciada (normalizada conforme exigido pela especificação XML) ou nulo se nenhuma foi fornecida.
- baseURI
- String
O URI no que diz respeito a quais systemIDs relativos são interpretados. Esse é sempre um URI absoluto, a menos que seja nulo (provavelmente porque o XMLReader recebeu um InputSource sem um). Esse URI é definido pela especificação XML como sendo o associado ao "<" iniciando a declaração relevante.
- systemId
- String
O identificador do sistema da entidade externa que está sendo referenciada; um URI relativo ou absoluto. Isso nunca é nulo quando invocado por um analisador SAX2; somente entidades declaradas e qualquer subconjunto externo são resolvidas por esses analisadores.
Retornos
Um objeto InputSource que descreve a nova fonte de entrada a ser usada pelo analisador. Retornar nulo direciona o analisador para resolver a ID do sistema em relação ao URI base e abrir uma conexão com o URI resultante.
- Atributos
Exceções
Qualquer exceção SAX, possivelmente encapsulando outra exceção.
Provavelmente indicando uma falha ao criar um novo InputStream ou Leitor ou uma URL ilegal.
Comentários
Permite que os aplicativos mapeiem referências a entidades externas em fontes de entrada ou informem ao analisador que ele deve usar a resolução de URI convencional. Esse método é chamado apenas para entidades externas que foram declaradas corretamente. Esse método fornece mais flexibilidade do que a interface, dando suporte a EntityResolver implementações de esquemas de catálogo mais complexos, como aquele definido pela especificação de Catálogos XML do OASIS .</p>
Os analisadores configurados para usar esse método resolvedor o chamarão para determinar a fonte de entrada a ser usada para qualquer entidade externa incluída devido a uma referência no texto XML. Isso exclui a entidade do documento e qualquer entidade externa retornada por #getExternalSubset getExternalSubset(). Quando um processador (não validando) é configurado para não incluir uma classe de entidades (parâmetro ou geral) por meio do uso de sinalizadores de recursos, esse método não é invocado para essas entidades.
Observe que o esquema de nomenclatura de entidade usado aqui é o mesmo usado no LexicalHandlermétodo ou no org.xml.sax.ContentHandler#skippedEntity ContentHandler.skippedEntity() método.
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.