IEntityResolver2.ResolveEntity(String, String, String, String) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Permite a las aplicaciones asignar referencias a entidades externas en orígenes de entrada o indicar al analizador que debe usar la resolución 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 la entidad externa que se va a resolver. "[dtd]" para el subconjunto externo o un nombre a partir de "%" para indicar una entidad de parámetro, o bien el nombre de una entidad general. Esto nunca es null cuando se invoca mediante un analizador SAX2.
- publicId
- String
Identificador público de la entidad externa a la que se hace referencia (normalizado según lo requerido por la especificación XML) o null si no se proporcionó ninguno.
- baseURI
- String
Identificador URI con respecto a los identificadores del sistema relativos que se interpretan. Esto siempre es un URI absoluto, a menos que sea null (probablemente porque xmlReader se le ha dado un InputSource sin uno). Esta URI se define mediante la especificación XML para que sea la asociada a la "<" iniciando la declaración pertinente.
- systemId
- String
Identificador del sistema de la entidad externa a la que se hace referencia; un URI relativo o absoluto. Esto nunca es nulo cuando se invoca mediante un analizador SAX2; solo las entidades declaradas y cualquier subconjunto externo se resuelven mediante estos analizadores.
Devoluciones
Objeto InputSource que describe el nuevo origen de entrada que va a usar el analizador. Devolver null dirige al analizador para resolver el identificador del sistema en el URI base y abrir una conexión con el URI resultante.
- Atributos
Excepciones
Cualquier excepción SAX, posiblemente encapsulando otra excepción.
Probablemente indique un error al crear un nuevo InputStream o Lector, o una dirección URL no válida.
Comentarios
Permite a las aplicaciones asignar referencias a entidades externas en orígenes de entrada o indicar al analizador que debe usar la resolución de URI convencional. Este método solo se llama a para entidades externas que se han declarado correctamente. Este método proporciona más flexibilidad que la EntityResolver interfaz, que admite implementaciones de esquemas de catálogo más complejos, como el definido por la especificación de catálogos XML oasis.</p>
Los analizadores configurados para usar este método de resolución lo llamarán para determinar el origen de entrada que se usará para cualquier entidad externa que se incluya debido a una referencia en el texto XML. Esto excluye la entidad de documento y cualquier entidad externa devuelta por #getExternalSubset getExternalSubset(). Cuando se configura un procesador (sin validación) para no incluir una clase de entidades (parámetro o general) mediante el uso de marcas de características, este método no se invoca para estas entidades.
Tenga en cuenta que el esquema de nomenclatura de entidades que se usa aquí es el mismo que se usa en LexicalHandler, o en el org.xml.sax.ContentHandler#skippedEntity ContentHandler.skippedEntity() método .
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.