IAttr Interface

Definição

Namespace:: Org.W3c.Dom

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

A Attr interface representa um atributo em um 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

Implementações: IJavaObject IJavaPeerable INode IDisposable

Comentários

A Attr interface representa um atributo em um Element objeto. Normalmente, os valores permitidos para o atributo são definidos em um esquema associado ao documento.

Attr os objetos herdam a Node interface, mas como eles não são realmente nós filho do elemento que descrevem, o DOM não os considera parte da árvore de documentos. Assim, os Node atributos parentNodepreviousSiblinge nextSibling têm um null valor para Attr objetos. O DOM usa a exibição de que os atributos são propriedades de elementos em vez de ter uma identidade separada dos elementos aos quais estão associados; isso deve tornar mais eficiente implementar recursos como atributos padrão associados a todos os elementos de um determinado tipo. Além disso, Attr os nós podem não ser filhos imediatos de um DocumentFragment. No entanto, eles podem ser associados a Element nós contidos em um DocumentFragment. Em suma, os usuários e os implementadores do DOM precisam estar cientes de que Attr os nós têm algumas coisas em comum com outros objetos herdando a Node interface, mas eles também são bastante distintos.

O valor efetivo do atributo é determinado da seguinte maneira: se esse atributo tiver sido atribuído explicitamente a qualquer valor, esse valor será o valor efetivo do atributo; caso contrário, se houver uma declaração para esse atributo e essa declaração incluir um valor padrão, esse valor padrão será o valor efetivo do atributo; caso contrário, o atributo não existe nesse elemento no modelo de estrutura até que ele tenha sido adicionado explicitamente. Observe que o Node.nodeValue atributo na Attr instância também pode ser usado para recuperar a versão da cadeia de caracteres dos valores do atributo.

Se o atributo não tiver recebido explicitamente um valor no documento da instância, mas tiver um valor padrão fornecido pelo esquema associado ao documento, um nó de atributo será criado com specified set to false. Remover nós de atributo para os quais um valor padrão é definido no esquema gera um novo nó de atributo com o valor padrão e specified definido como false. Se a validação ocorreu durante a invocação Document.normalizeDocument(), nós de atributo com specified iguais a false são recomputados de acordo com os valores de atributo padrão fornecidos pelo esquema. Se nenhum valor padrão for associado a esse atributo no esquema, o nó de atributo será descartado.

No XML, em que o valor de um atributo pode conter referências de entidade, os nós filho do Attr nó podem ser ou TextEntityReference nós (quando eles estiverem em uso; consulte a descrição para EntityReference discussão).

O DOM Core representa todos os valores de atributo como cadeias de caracteres simples, mesmo que o DTD ou o esquema associado ao documento os declare de algum tipo específico, como tokenizado.

A maneira como a normalização do valor do atributo é executada pela implementação do DOM depende do quanto a implementação sabe sobre o esquema em uso. Normalmente, o e value os nodeValue atributos de um Attr nó inicialmente retornam o valor normalizado fornecido pelo analisador. Também é o caso depois Document.normalizeDocument() de ser chamado (supondo que as opções certas tenham sido definidas). Mas esse pode não ser o caso após a mutação, independentemente de a mutação ser executada definindo o valor da cadeia de caracteres diretamente ou alterando os Attr nós filho. Em particular, isso é verdadeiro quando as referências de caractere estão envolvidas , considerando que elas não são representadas no DOM e afetam a normalização do valor do atributo. Por outro lado, se a implementação souber sobre o esquema em uso quando o valor do atributo for alterado e for de um tipo diferente do CDATA, ele poderá normalizá-lo novamente nesse momento. Isso é especialmente verdadeiro para implementações de DOM especializadas, como implementações SVG DOM, que armazenam valores de atributo em uma forma interna diferente de uma cadeia de caracteres.

A tabela a seguir fornece alguns exemplos das relações entre o valor do atributo no documento original (atributo analisado), o valor exposto no DOM e a serialização do valor: <table border='1' cellpadding='3'tr><>< th>Examples</th th><>Parsed attribute value</th><>InitialAttr.value< /th th><>Serialized attribute value</th></tr tr><><td valign='top' rowspan='1' colspan='1'> Referência< de caractere/td td><valign='top' rowspan='1' colspan='1'>

"x&#178;=5"