ILSParser Interfaz

Referencia

Definición

Espacio de nombres:: Org.W3c.Dom.LS

Ensamblado:: Mono.Android.dll

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í.

Interfaz a un objeto que puede compilar, o aumentar, un árbol DOM de varios orígenes de entrada.

[Android.Runtime.Register("org/w3c/dom/ls/LSParser", "", "Org.W3c.Dom.LS.ILSParserInvoker")]
public interface ILSParser : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("org/w3c/dom/ls/LSParser", "", "Org.W3c.Dom.LS.ILSParserInvoker")>]
type ILSParser = interface
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Atributos: RegisterAttribute

Implementaciones: IJavaObject IJavaPeerable IDisposable

Comentarios

Interfaz a un objeto que puede compilar, o aumentar, un árbol DOM de varios orígenes de entrada.

LSParser proporciona una API para analizar XML y crear la estructura de documentos DOM correspondiente. Se puede obtener una LSParser instancia invocando el DOMImplementationLS.createLSParser() método .

Como se especifica en [DOM Level 3 Core], cuando un documento se pone a disposición por primera vez a través de LSParser: <ul><li> nunca habrá dos nodos adyacentes de tipo NODE_TEXT y nunca habrá nodos de texto vacíos. </li li>>< se espera que los value atributos y nodeValue de un Attr nodo devuelvan inicialmente el valor normalizado XML 1.0. Sin embargo, si los parámetros " validate-if-schema" y " datatype-normalization" se establecen trueen , dependiendo de la normalización de atributos usada, los valores de atributo pueden diferir de los obtenidos por la normalización del atributo XML 1.0. Si los parámetros " datatype-normalization" se establecen falseen , se garantiza que se produce la normalización de atributos XML 1.0 y, si la lista de atributos no contiene declaraciones de espacio de nombres, el attributes atributo en Element el nodo representa la propiedad [attributes] definida en [Conjunto de información XML] . </li></ul>

Se espera que los objetos asincrónicos LSParser también implementen la events::EventTarget interfaz para que los agentes de escucha de eventos se puedan registrar en objetos asincrónicos LSParser .

Los eventos admitidos por objetos asincrónicos LSParser son: <dl<>dt>load</dt><dd> Finaliza LSParser para cargar el documento. Consulte también la definición de la LSLoadEvent interfaz. </dd><dt>progress</dt><dd> El LSParser progreso de las señales a medida que se analizan los datos. Esta especificación no intenta definir exactamente cuándo se deben enviar los eventos de progreso. Esto se deja intencionadamente como dependiente de la implementación. Este es un ejemplo de cómo una aplicación puede enviar eventos de progreso: una vez que el analizador comienza a recibir datos, se envía un evento de progreso para indicar que se inicia el análisis. Desde allí, se envía un evento de progreso por cada 4096 bytes de datos que se reciben y procesan. Sin embargo, este es solo un ejemplo, y las implementaciones pueden optar por enviar eventos de progreso en cualquier momento al analizarlos o no enviarlos en absoluto. Consulte también la definición de la LSProgressEvent interfaz. </dd></dl>Note: Todos los eventos definidos en esta especificación usan el URI "http://www.w3.org/2002/DOMLS"del espacio de nombres .

Al analizar un origen de entrada, los errores se notifican a la aplicación a través del controlador de errores (LSParser.domConfigel parámetro " error-handler"). Esta especificación no intenta definir de ninguna manera todos los posibles errores que pueden producirse al analizar XML o cualquier otro marcado, pero se definen algunos casos de error comunes. Los tipos (DOMError.type) de errores y advertencias definidos por esta especificación son: <dl><dt/dt><<>"check-character-normalization-failure" [error] dd Raised> si el parámetro " check-character-normalization" está establecido en true y se encuentra una cadena que produce un error en la comprobación de normalización. </dd><dt>"doctype-not-allowed" [fatal]</dt><dd> Se genera si el parámetro de configuración "disallow-doctype" está establecido true en y se encuentra un doctype. </dd><dt>"no-input-specified" [fatal]</dt><dd> Se genera al cargar un documento y no se especifica ninguna entrada en el LSInput objeto . </dd><dt>"pi-base-uri-not-preserved" [warning]</dt><dd> Se genera si se encuentra una instrucción de procesamiento en una ubicación donde no se puede conservar el URI base de la instrucción de procesamiento. Un ejemplo de caso en el que se generará esta advertencia es si el parámetro de configuración " entities" está establecido false en y se analiza el siguiente archivo XML:

&lt;!DOCTYPE root [ &lt;!ENTITY e SYSTEM 'subdir/myentity.ent' ]&gt;
            &lt;root&gt; &amp;e; &lt;/root&gt;

Y subdir/myentity.ent contiene:

&lt;one&gt; &lt;two/&gt; &lt;/one&gt; &lt;?pi 3.14159?&gt;
            &lt;more/&gt;

</dd><dt>"unbound-prefix-in-entity" [warning]</dt><dd> Advertencia dependiente de la implementación que se puede generar si el parámetro de configuración " espacios de nombres" está establecido true en y se encuentra un prefijo de espacio de nombres sin enlazar en el texto de reemplazo de una entidad. No se aplica la generación de esta advertencia, ya que es posible que algunos analizadores existentes no reconozcan prefijos de espacio de nombres sin enlazar en el texto de reemplazo de entidades. </dd><dt>"unknown-character-denormalization" [fatal]</dt><dd> Se genera si el parámetro de configuración "ignore-unknown-character-denormalizations" está establecido false en y se encuentra un carácter para el que el procesador no puede determinar las propiedades de normalización. </dd><dt>"unsupported-encoding" [fatal]</dt><dd> Se genera si se encuentra una codificación no admitida. </dd><dt>"unsupported-media-type" [fatal]</dt><dd> Se genera si se establece true el parámetro de configuración "supported-media-types-only" en y se encuentra un tipo de medio no admitido. </dd></dl>

Además de generar los errores y advertencias definidos, se espera que las implementaciones generen errores y advertencias específicos de implementación para cualquier otro error y casos de advertencia, como errores de E/S (archivo no encontrado, permiso denegado,...), errores de forma correcta XML, etc.

Consulte también la Especificación de carga y guardado del modelo de objetos de documento (DOM).

Documentación de Java para org.w3c.dom.ls.LSParser.

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.

Campos

ActionAppendAsChildren	Anexe el resultado de la operación de análisis como elementos secundarios del nodo de contexto.
ActionInsertAfter	Inserte el resultado de la operación de análisis como el elemento relacionado inmediatamente siguiente del nodo de contexto.
ActionInsertBefore	Inserte el resultado de la operación de análisis como elemento relacionado inmediatamente anterior del nodo de contexto.
ActionReplace	Reemplace el nodo de contexto por el resultado de la operación de análisis.
ActionReplaceChildren	Reemplace todos los elementos secundarios del nodo de contexto por el resultado de la operación de análisis.

Propiedades

Async	`trueLSParser` si es asincrónico, `false` si es sincrónico.
Busy	`true` si el `LSParser` objeto está ocupado actualmente cargando un documento; de lo contrario `false`, .
DomConfig	Objeto `DOMConfiguration` utilizado al analizar un origen de entrada.
Filter	Cuando se proporciona un filtro, la implementación llamará al filtro a medida que construye la estructura del árbol DOM.
Handle	Obtiene el valor JNI del objeto Android subyacente. (Heredado de IJavaObject)
JniIdentityHashCode	Devuelve el valor de `java.lang.System.identityHashCode()` para la instancia ajustada. (Heredado de IJavaPeerable)
JniManagedPeerState	Estado del mismo nivel administrado. (Heredado de IJavaPeerable)
JniPeerMembers	Compatibilidad con la invocación y el acceso de miembros. (Heredado de IJavaPeerable)
PeerReference	Devuelve una JniObjectReference de la instancia de objeto Java ajustada. (Heredado de IJavaPeerable)

Métodos

Abort()	Anule la carga del documento que está cargando actualmente .`LSParser`
Disposed()	Se llama cuando se ha eliminado la instancia. (Heredado de IJavaPeerable)
DisposeUnlessReferenced()	Si no hay referencias pendientes a esta instancia, llama a `Dispose()`; de lo contrario, no hace nada. (Heredado de IJavaPeerable)
Finalized()	Se llama cuando se ha finalizado la instancia. (Heredado de IJavaPeerable)
Parse(ILSInput)	Analice un documento XML de un recurso identificado por .`LSInput`
ParseURI(String)	Analice un documento XML desde una ubicación identificada por una referencia de URI [IETF RFC 2396].
ParseWithContext(ILSInput, INode, Int16)	Analice un fragmento XML de un recurso identificado por `LSInput` e inserte el contenido en un documento existente en la posición especificada con los `context` argumentos y `action` .
SetJniIdentityHashCode(Int32)	Establezca el valor devuelto por `JniIdentityHashCode`. (Heredado de IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	Interfaz a un objeto que puede compilar, o aumentar, un árbol DOM de varios orígenes de entrada. (Heredado de IJavaPeerable)
SetPeerReference(JniObjectReference)	Establezca el valor devuelto por `PeerReference`. (Heredado de IJavaPeerable)
UnregisterFromRuntime()	Anule el registro de esta instancia para que el entorno de ejecución no lo devuelva de invocaciones futuras Java.Interop.JniRuntime+JniValueManager.PeekValue . (Heredado de IJavaPeerable)

Métodos de extensión

JavaCast<TResult>(IJavaObject)	Realiza una conversión de tipos comprobados en tiempo de ejecución de Android.
JavaCast<TResult>(IJavaObject)	Interfaz a un objeto que puede compilar, o aumentar, un árbol DOM de varios orígenes de entrada.
GetJniTypeName(IJavaPeerable)	Interfaz a un objeto que puede compilar, o aumentar, un árbol DOM de varios orígenes de entrada.
ParseAsync(ILSParser, ILSInput)	Interfaz a un objeto que puede compilar, o aumentar, un árbol DOM de varios orígenes de entrada.
ParseURIAsync(ILSParser, String)	Interfaz a un objeto que puede compilar, o aumentar, un árbol DOM de varios orígenes de entrada.
ParseWithContextAsync(ILSParser, ILSInput, INode, Int16)	Interfaz a un objeto que puede compilar, o aumentar, un árbol DOM de varios orígenes de entrada.

Se aplica a

Compartir a través de