IAttr Interfaz

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 Attr interfaz representa un atributo en un Element objeto .

[Android.Runtime.Register("org/w3c/dom/Attr", "", "Org.W3c.Dom.IAttrInvoker")]
public interface IAttr : IDisposable, Java.Interop.IJavaPeerable, Org.W3c.Dom.INode

[<Android.Runtime.Register("org/w3c/dom/Attr", "", "Org.W3c.Dom.IAttrInvoker")>]
type IAttr = interface
    interface INode
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Atributos: RegisterAttribute

Implementaciones: IJavaObject IJavaPeerable INode IDisposable

Comentarios

La Attr interfaz representa un atributo en un Element objeto . Normalmente, los valores permitidos para el atributo se definen en un esquema asociado al documento.

Attr los objetos heredan la Node interfaz, pero dado que no son realmente nodos secundarios del elemento que describen, el DOM no los considera parte del árbol de documentos. Por lo tanto, los atributos , y Node tienen un parentNode valor para previousSibling los nextSiblingobjetos .nullAttr El DOM toma la vista de que los atributos son propiedades de elementos en lugar de tener una identidad independiente de los elementos a los que están asociados; esto debería hacer que sea más eficaz implementar características como atributos predeterminados asociados a todos los elementos de un tipo determinado. Además, es posible que Attr los nodos no sean elementos secundarios inmediatos de .DocumentFragment Sin embargo, se pueden asociar a Element los nodos contenidos en un DocumentFragment. En resumen, los usuarios e implementadores del DOM deben tener en cuenta que Attr los nodos tienen algunas cosas en común con otros objetos que heredan la Node interfaz, pero también son bastante distintos.

El valor efectivo del atributo se determina de la siguiente manera: si este atributo se ha asignado explícitamente a cualquier valor, ese valor es el valor efectivo del atributo; de lo contrario, si hay una declaración para este atributo y esa declaración incluye un valor predeterminado, ese valor predeterminado es el valor efectivo del atributo; De lo contrario, el atributo no existe en este elemento del modelo de estructura hasta que se haya agregado explícitamente. Tenga en cuenta que el Node.nodeValue atributo de la Attr instancia también se puede usar para recuperar la versión de cadena de los valores del atributo.

Si el atributo no se proporcionó explícitamente un valor en el documento de instancia, pero tiene un valor predeterminado proporcionado por el esquema asociado al documento, se creará un nodo de atributo con establecido specifieden false . Al quitar nodos de atributo para los que se define un valor predeterminado en el esquema, se genera un nuevo nodo de atributo con el valor predeterminado y specified se establece en false. Si se produjo la validación al invocar Document.normalizeDocument(), los nodos de atributo con specified iguales a se vuelven a false calcular según los valores de atributo predeterminados proporcionados por el esquema. Si no hay ningún valor predeterminado asociado a este atributo en el esquema, se descarta el nodo de atributo.

En XML, donde el valor de un atributo puede contener referencias de entidad, los nodos secundarios del Attr nodo pueden ser Text o EntityReference nodos (cuando están en uso; vea la descripción de EntityReference para su discusión).

DOM Core representa todos los valores de atributo como cadenas simples, incluso si el DTD o el esquema asociado al documento los declara de algún tipo específico, como tokenizado.

La normalización del valor de atributo se realiza mediante la implementación dom depende de cuánto sabe la implementación sobre el esquema en uso. Normalmente, los value atributos y nodeValue de un Attr nodo devuelven inicialmente el valor normalizado proporcionado por el analizador. También es el caso después Document.normalizeDocument() de llamar a (suponiendo que se han establecido las opciones correctas). Pero esto no puede ser el caso después de la mutación, independientemente de si la mutación se realiza estableciendo el valor de cadena directamente o cambiando los Attr nodos secundarios. En concreto, esto es cierto cuando las referencias de caracteres están implicadas , dado que no se representan en el DOM y afectan a la normalización del valor de atributo. Por otro lado, si la implementación conoce el esquema en uso cuando se cambia el valor del atributo y es de un tipo diferente al de CDATA, puede normalizarlo de nuevo en ese momento. Esto es especialmente cierto en las implementaciones dom especializadas, como las implementaciones SVG DOM, que almacenan valores de atributo en un formato interno diferente de una cadena.

En la tabla siguiente se proporcionan algunos ejemplos de las relaciones entre el valor del atributo en el documento original (atributo analizado), el valor tal como se expone en el DOM y la serialización del valor: <table border='1' cellpadding='3'tr><>< th>Examples</th><>Parsed attribute value</><>th Initial Attr.value</th><>Serialized attribute value</th></tr tr tr><><td valign='top' rowspan='1' colspan='1'> Character reference</td td><valign='top' rowspan='1' colspan='1'>

"x&#178;=5"