IDOMConfiguration Interfaz

Referencia

Definición

Espacio de nombres:: Org.W3c.Dom

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

La DOMConfiguration interfaz representa la configuración de un documento y mantiene una tabla de parámetros reconocidos.

[Android.Runtime.Register("org/w3c/dom/DOMConfiguration", "", "Org.W3c.Dom.IDOMConfigurationInvoker")]
public interface IDOMConfiguration : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("org/w3c/dom/DOMConfiguration", "", "Org.W3c.Dom.IDOMConfigurationInvoker")>]
type IDOMConfiguration = interface
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Atributos: RegisterAttribute

Implementaciones: IJavaObject IJavaPeerable IDisposable

Comentarios

La DOMConfiguration interfaz representa la configuración de un documento y mantiene una tabla de parámetros reconocidos. Con la configuración, es posible cambiar Document.normalizeDocument() el comportamiento, como reemplazar los CDATASection nodos por Text nodos o especificar el tipo del esquema que se debe usar cuando se solicita la validación de .Document DOMConfiguration Los objetos también se usan en [DOM Level 3 Load and Save] en las DOMParser interfaces y DOMSerializer .

Los nombres de parámetro utilizados por el DOMConfiguration objeto se definen a lo largo de las especificaciones dom Level 3. Los nombres no distinguen mayúsculas de minúsculas. Para evitar posibles conflictos, como convención, los nombres que hacen referencia a los parámetros definidos fuera de la especificación DOM deben ser únicos. Dado que los parámetros se exponen como propiedades en , se recomienda que los nombres sigan la sección 5.16 Identificadores de [Unicode] con la adición del carácter '-' (HYPHEN-MINUS), pero la implementación de DOM no la aplica. Las implementaciones principales de NIVEL 3 dom son necesarias para reconocer todos los parámetros definidos en esta especificación. Es posible que la implementación también admita algunos valores de parámetro. Consulte la definición del parámetro para saber si se debe admitir o no un valor. Note: Parameters son similares a las características y propiedades usadas en SAX2 [SAX].

La siguiente lista de parámetros definidos en dom: dl>dt/dt><>"canonical-form"< dd<>dl<>dt/dtd dt>true</dtd><>[optional] Canónicamente el documento según las reglas especificadas en [XML canónico], como quitar el DocumentType nodo (si existe) del árbol o quitar declaraciones de espacio de nombres superfluos de cada elemento.<< Tenga en cuenta que esto se limita a lo que se puede representar en el DOM; en concreto, no hay ninguna manera de especificar el orden de los atributos en el DOM. Además, al establecer este parámetro true en también se establecerá el estado de los parámetros que se enumeran a continuación. Los cambios posteriores en el estado de uno de esos parámetros revertirán "forma canónica" a false. Parámetros establecidos en false: "entities", "normalize-characters", "cdata-sections". Parámetros establecidos en true: "namespaces", "namespace-declarations", "well-form", "element-content-whitespace". Otros parámetros no se cambian a menos que se especifique explícitamente en la descripción de los parámetros.</dd><dt>false</dt><dd>[required] (default)No canónicamente el documento.</dd></dl></dd><dt><"cdata-sections"/dt><dd><dl><dt><true/dt><dd>[required] (default)Mantener CDATASection nodos en el documento.</dd><dt>false</dt><dd>[required]Transformar CDATASection nodos del documento en Text nodos. A continuación, el nuevo Text nodo se combina con cualquier nodo adyacenteText.</dd></dl></dd><dt>"check-character-normalization"</dt><dd><dl><dt><true/dt><dd>[optional] Compruebe si los caracteres del documento están totalmente normalizados, tal como se define en el apéndice B de [XML 1.1]. Cuando se encuentra una secuencia de caracteres que produce un error en la comprobación de normalización, se emite un error con el DOMError.type valor de "check-character-normalization-failure". </dd><dt>false</dt><dd>[required] (default)No compruebe si se normalizan los caracteres.</dd></dl></dd><dt><"comments"/dt><dd><dl><dt><true/dt><dd>[required] (default)Mantener Comment nodos en el documento.</dd><dt>false</dt><dd>[required]Descartar Comment nodos en el documento.</dd></dl></dd><dt>"datatype-normalization"</dt><dd><dl><dt>true</dt><dd>[optional] Exponga los valores normalizados del esquema en el árbol, como los valores normalizados del esquema XML en el caso del esquema XML. Dado que este parámetro requiere tener información de esquema, el parámetro "validate" también se establecerá en true. Tener este parámetro activado cuando "validate" no tiene false ningún efecto y no se producirá ninguna normalización de esquema. Note: Dado que el documento contiene el resultado del procesamiento XML 1.0, este parámetro no se aplica a la normalización del valor de atributo tal como se define en la sección 3.3.3 de [XML 1.0] y solo está pensada para lenguajes de esquema distintos de definición de tipo de documento (DTD). </dd><dt>false</dt><dd>[required] (default) No realice la normalización del esquema en el árbol. </dd></dl></dd><dt><"element-content-whitespace"/dt><dd><dl><dt>true</dt><dd>[required] (default)Mantenga todos los espacios en blanco del documento.</dd><dt>false</dt><dd>[optional] Descarte todos los Text nodos que contienen espacios en blanco en el contenido del elemento, como se describe en [espacio en blanco de contenido del elemento]. Se espera que la implementación use el atributo Text.isElementContentWhitespace para determinar si se debe descartar o no un Text nodo.</dd></dl></dd><dt><"entities"/dt><dd><dl><dt><true/dt><dd>[required] (default)Mantener EntityReference nodos en el documento.</dd><dt>false</dt><dd>[required] Quite todos los EntityReference nodos del documento, colocando las expansiones de entidad directamente en su lugar. Text Los nodos se normalizan, tal como se define en Node.normalize. Solo las referencias de entidad no expandidas se conservan en el documento. </dd></dl>Note: Este parámetro no afecta a Entity los nodos. </dd><dt>"error-handler"</dt><dd>[required] Contiene un DOMErrorHandler objeto . Si se produce un error en el documento, la implementación volverá a llamar al DOMErrorHandler registrado mediante este parámetro. La implementación puede proporcionar un objeto predeterminado DOMErrorHandler . Cuando se llame a , DOMError.relatedData contendrá el nodo más cercano a donde se produjo el error. Si la implementación no puede determinar el nodo donde se produce el error, DOMError.relatedData contendrá el Document nodo . Las mutaciones en el documento desde dentro de un controlador de errores darán lugar a un comportamiento dependiente de la implementación. </dd><dt>"infoset"</dt><dd><dl><dt>true</dt><dd>[required]Mantenga en el documento la información definida en el conjunto de información XML [Conjunto de información XML] . Esto fuerza los parámetros siguientes a false: " validate-if-schema", "entities", "datatype-normalization", "cdata-sections". Esto fuerza los parámetros siguientes a true: " namespace-declarations", "well-form", "element-content-whitespace", " comments", "namespaces". Otros parámetros no se cambian a menos que se especifique explícitamente en la descripción de los parámetros. Tenga en cuenta que la consulta de este parámetro con getParameter devuelve true solo si se establecen correctamente los parámetros individuales especificados anteriormente.</dd><dt>false</dt><dd>Setting infoset to false no tiene ningún efecto.</dd></dl></dd><dt>"namespaces"</dt><dd><dl><dt>true</dt><dd>[required] (default) Realice el procesamiento del espacio de nombres tal como se define en . </dd><dt><false/dt><dd>[optional] No realice el procesamiento del espacio de nombres. </dd></dl></dd><dt>"namespace-declarations"</dt><dd> Este parámetro no tiene ningún efecto si el parámetro "espacios de nombres" está establecido falseen . <dl><dt>true</dt><dd>[required] (default) Incluir atributos de declaración de espacio de nombres, especificados o predeterminados del esquema, en el documento. Vea también las secciones "Declarar espacios de nombres" en [Espacios de nombres XML] y [Espacios de nombres XML 1.1] .</dd><dt><false/dt><dd>[required]Descarte todos los atributos de declaración de espacio de nombres. Los prefijos de espacio de nombres ( Node.prefix) se conservan aunque este parámetro esté establecido en false.</dd></dl></dd><dt><"normalize-characters"/dt><dd><dl><dt>true</dt><dd>[optional] Normalizar completamente los caracteres del documento tal y como se define en el apéndice B de [XML 1.1]. </dd><dt>false</dt><dd>[required] (default)No realice la normalización de caracteres.</dd></dl></dd><dt>"schema-location"</dt><dd>[optional] Representa un DOMString objeto que contiene una lista de URI, separados por espacios en blanco (caracteres que coinciden con la producción noterminal S definida en la sección 2.3 [XML 1.0]), que representa los esquemas con los que debe producirse la validación, es decir, el esquema actual. Los tipos de esquemas a los que se hace referencia en esta lista deben coincidir con el tipo especificado con schema-type; de lo contrario, el comportamiento de una implementación no está definido. Los esquemas especificados mediante esta propiedad tienen prioridad sobre la información de esquema especificada en el propio documento. En el caso del esquema compatible con el espacio de nombres, si un esquema especificado con esta propiedad y un esquema especificado en la instancia del documento (es decir, mediante el schemaLocation atributo ) de un documento de esquema (es decir, mediante mecanismos de esquema import ) comparten el mismo targetNamespace, se usará el esquema especificado por el usuario mediante esta propiedad. Si dos esquemas especificados con esta propiedad comparten el mismo targetNamespace espacio de nombres o no tienen ningún espacio de nombres, el comportamiento depende de la implementación. Si no se ha proporcionado ninguna ubicación, este parámetro es null. Note: El "schema-location" parámetro se omite a menos que se establezca el valor del parámetro "schema-type". Se recomienda Document.documentURI encarecidamente establecer para que una implementación pueda resolver correctamente las entidades externas a las que se hace referencia. </dd><dt>"schema-type"</dt><dd>[optional] Representa un DOMString objeto que contiene un URI absoluto y representa el tipo del lenguaje de esquema usado para validar un documento. Tenga en cuenta que no se realiza ninguna comprobación léxica en el URI absoluto. Si no se establece este parámetro, la implementación puede proporcionar un valor predeterminado, en función de los lenguajes de esquema admitidos y en el lenguaje de esquema usado en tiempo de carga. Si no se proporciona ningún valor, este parámetro es null. Note: For XML Schema [XML Schema Part 1] , las aplicaciones deben usar el valor "http://www.w3.org/2001/XMLSchema". Para DTD XML [XML 1.0], las aplicaciones deben usar el valor "http://www.w3.org/TR/REC-xml". Otros lenguajes de esquema están fuera del ámbito de W3C y, por lo tanto, deben recomendar un URI absoluto para usar este método. </dd><dt>"split-cdata-sections"</dt><dd><dl><dt>true</dt><dd>[required] (default)Dividir secciones CDATA que contienen el marcador de terminación de sección CDATA ']]>'. Cuando una sección de CDATA se divide, se emite una advertencia con un DOMError.type valor igual a "cdata-sections-splitted" y DOMError.relatedData igual al primer CDATASection nodo en el orden del documento resultante de la división.</dd><dt>false</dt><dd>[required]Señal de un error si contiene CDATASection un carácter nopresentable.</dd></dl></dd><dt>"validate"</dt><dd><dl><dt>true</dt><dd>[optional] Requerir la validación en un esquema (i.e. XML esquema, DTD, cualquier otro tipo o representación del esquema) del documento tal como se está normalizando según lo definido por [XML 1.0]. Si se encuentran errores de validación o no se encontró ningún esquema, se notificará al controlador de errores. Los valores normalizados por esquema no se exponen según el esquema en usado a menos que el parámetro "datatype-normalization" sea true. Este parámetro volverá a evaluar: <ul><li> Attribute nodes with Attr.specified equals to false, as specified in the description of the Attr interface; </li li>>< El valor del atributo Text.isElementContentWhitespace para todos los Text nodos; </li li>>< El valor del atributo Attr.isId para todos los Attr nodos; </li li>>< Los atributos Element.schemaTypeInfo y .Attr.schemaTypeInfo </li></ul>Note: "validate-if-schema" y "validate" son mutuamente excluyentes, estableciendo uno de ellos en true establecerá el otro en false. Las aplicaciones también deben considerar la posibilidad de establecer el parámetro "bien formado" trueen , que es el valor predeterminado para esa opción, al validar el documento. </dd><dt>false</dt><dd>[required] (default) No realice el procesamiento del esquema, incluido el procesamiento del subconjunto interno. Se mantiene la información de los valores de atributo predeterminados. Tenga en cuenta que la validación puede seguir sucediendo si "validate-if-schema" es true . </dd></dl></dd><dt>"validate-if-schema"</dt><dd><dl><dt><true/dt><dd>[optional]Habilitar validación solo si se puede encontrar una declaración para el elemento de documento en un esquema (independientemente de dónde se encuentre, i.e. XML esquema, DTD o cualquier otro tipo o representación del esquema). Si la validación está habilitada, este parámetro tiene el mismo comportamiento que el parámetro "validate" establecido en true. Nota: "validate-if-schema" y "validate" son mutuamente excluyentes, estableciendo uno de ellos en true establecerá el otro en false. </dd><dt>false</dt><dd>[required] (default) No se debe realizar ningún procesamiento de esquema si el documento tiene un esquema, incluido el procesamiento de subconjuntos interno. Se mantiene la información de los valores de atributo predeterminados. Tenga en cuenta que la validación debe seguir sucediendo si "validate" es true. </dd></dl></dd><dt><"well-formed"/dt><dd><dl><dt>true</dt><dd>[required] (default) Compruebe si todos los nodos tienen un formato XML correcto según la versión XML en uso en Document.xmlVersion: <ul><li> comprueba si el atributo Node.nodeName contiene caracteres no válidos según su tipo de nodo y genera un DOMError de tipo "wf-invalid-character-in-node-name", con una DOMError.SEVERITY_ERROR gravedad, si es necesario; </li li><> comprueba si el contenido de texto dentro Attrde , , ElementComment, Text, CDATASection nodos para caracteres no válidos y genera un DOMError de tipo "wf-invalid-character", con una DOMError.SEVERITY_ERROR gravedad, si es necesario; </li li>>< comprueba si los datos dentro ProcessingInstruction de los nodos para caracteres no válidos y generan un DOMError de tipo "wf-invalid-character", con una DOMError.SEVERITY_ERROR gravedad, si es necesario; </li></ul></dd><dt>false</dt><dd>[optional] No compruebe si hay un formato correcto xml. </dd></dl></dd></dl>

La resolución de los identificadores del sistema asociados a las entidades se realiza mediante Document.documentURI. Sin embargo, cuando la característica "LS" definida en [DOM Level 3 Load and Save] es compatible con la implementación de DOM, el parámetro "resource-resolver" también se puede usar en DOMConfiguration objetos conectados a Document nodos. Si se establece este parámetro, Document.normalizeDocument() invocará al solucionador de recursos en lugar de usar Document.documentURI.

Consulte también la especificación principal del modelo de objetos de documento (DOM) de nivel 3.

Agregado en DOM Level 3.

Documentación de Java para org.w3c.dom.DOMConfiguration.

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.

Propiedades

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)
ParameterNames	Lista de los parámetros admitidos por este `DOMConfiguration` objeto y para los que la aplicación puede establecer al menos un valor.
PeerReference	Devuelve una JniObjectReference de la instancia de objeto Java ajustada. (Heredado de IJavaPeerable)

Métodos

CanSetParameter(String, Object)	Compruebe si se admite la configuración de un parámetro en un valor específico.
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)
GetParameter(String)	Devuelve el valor de un parámetro si se conoce.
SetJniIdentityHashCode(Int32)	Establezca el valor devuelto por `JniIdentityHashCode`. (Heredado de IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)	La `DOMConfiguration` interfaz representa la configuración de un documento y mantiene una tabla de parámetros reconocidos. (Heredado de IJavaPeerable)
SetParameter(String, Object)	Establezca el valor de un parámetro.
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)	La `DOMConfiguration` interfaz representa la configuración de un documento y mantiene una tabla de parámetros reconocidos.
GetJniTypeName(IJavaPeerable)	La `DOMConfiguration` interfaz representa la configuración de un documento y mantiene una tabla de parámetros reconocidos.

Se aplica a

Compartir a través de