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 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 no lo exige la implementación de DOM. 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><"canonical-form"/dtd dl<>dt/dtd<<><>>ddtrue>><[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 está limitado 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, si se establece 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 la "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"</dtd<>><dl<>dttrue<>/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"</dtd<><>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 detecta 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"</dtd<>><dl<>dttrue<>/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"</dtd<<>>dl<>dttrue<>/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"/dtd><><dl><dttrue></dt><dd>[required] (default)Mantenga todos los espacios en blanco del documento.</dd><dt>false</dt><dd>[optional] Descarta todos los Text nodos que contienen espacios en blanco en el contenido del elemento, como se describe en [espacio en blanco de contenido de elementos]. 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"</dtd<>><dl<>dttrue<>/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, 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"</dtd<<>>dl<>dttrue<>/dt><dd>[required]Mantenga en el documento la información definida en el conjunto de información XML [Conjunto de información XML] . Esto obliga a 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"</dtd<<>>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 falseen .</dd></dl></dd><dt>"normalize-characters"</dtd<><>dl><dt><true/dt<>dd>[optional] Normalizó 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 con esta propiedad tienen prioridad sobre la información de esquema especificada en el propio documento. Para el esquema compatible con el espacio de nombres, si un esquema especificado con esta propiedad y un esquema especificado en la instancia de documento (es decir, mediante el schemaLocation atributo ) en un documento de esquema (es decir, mediante mecanismos de esquema import ) comparten el mismo targetNamespace, se usará el esquema especificado por el usuario que usa 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: Se omite el "schema-location" parámetro a menos que se establezca el valor del parámetro "schema-type". Se recomienda encarecidamente Document.documentURI 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 objeto que contiene un DOMString URI absoluto y representa el tipo del lenguaje de esquema utilizado 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 el momento de la 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"</dtd<><>dl<>dt<true>/dt><dd>[required] (default)Secciones CDATA divididas 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]Indica un error si un CDATASection contiene un carácter nopresentable.</dd></dl></dd><dt>"validate"</dtd<<>>dl<>dttrue<>/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 y como se está normalizando según lo define [XML 1.0]. Si se encuentran errores de validación o no se encontró ningún esquema, se notifica al controlador de errores. Los valores normalizados de 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 "correcto" 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 ocurriendo si "validate-if-schema" es true . </dd></dl></dd><dt><"validate-if-schema"/dtd><><dl<>dt<true>/dt<>dd>[optional]Habilitar la 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. Note: "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 interno de subconjuntos. Se mantiene la información de los valores de atributo predeterminados. Tenga en cuenta que la validación debe seguir ocurriendo si "validar" es true. </dd></dl></dd><dt>"well-formed"</dtd<><>dl><dt<true>/dt><dd>[] (>default) Compruebe si todos los nodos tienen un formato CORRECTO XML 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 generan 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 no son 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 implementación del DOM de nivel 3 admite la característica "LS" definida en 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 básica del modelo de objetos de documento (DOM) de nivel 3.

Se ha agregado en dom nivel 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 Project y que se usan según los términos Creative Commons 2.5 Attribution License.

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 a 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 Java.Interop.JniRuntime+JniValueManager.PeekValue futuras invocaciones. (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