Class Element

Class Element

Namespace: Aspose.Html.Dom
Assembly: Aspose.HTML.dll (25.1.0)

A interface Element representa um elemento em um documento HTML ou XML.

[ComVisible(true)]
[DOMObject]
[DOMName("Element")]
public class Element : Node, INotifyPropertyChanged, IEventTarget, IDisposable, IXPathNSResolver, IParentNode, IElementTraversal, IChildNode

Herança

objectDOMObjectEventTargetNodeElement

Derivados

HTMLElement, SVGElement

Implementa

INotifyPropertyChanged, IEventTarget, IDisposable, IXPathNSResolver, IParentNode, IElementTraversal, IChildNode

Membros Herdados

Node.ELEMENT_NODE, Node.ATTRIBUTE_NODE, Node.TEXT_NODE, Node.CDATA_SECTION_NODE, Node.ENTITY_REFERENCE_NODE, Node.ENTITY_NODE, Node.PROCESSING_INSTRUCTION_NODE, Node.COMMENT_NODE, Node.DOCUMENT_NODE, Node.DOCUMENT_TYPE_NODE, Node.DOCUMENT_FRAGMENT_NODE, Node.NOTATION_NODE, Node.HasChildNodes(), Node.Normalize(), Node.CloneNode(), Node.CloneNode(bool), Node.IsEqualNode(Node), Node.IsSameNode(Node), Node.LookupPrefix(string), Node.LookupNamespaceURI(string), Node.IsDefaultNamespace(string), Node.InsertBefore(Node, Node), Node.ReplaceChild(Node, Node), Node.RemoveChild(Node), Node.AppendChild(Node), Node.Dispose(bool), Node.ToString(), Node.NodeType, Node.LocalName, Node.NamespaceURI, Node.Prefix, Node.NodeName, Node.BaseURI, Node.OwnerDocument, Node.ParentNode, Node.ParentElement, Node.ChildNodes, Node.FirstChild, Node.LastChild, Node.PreviousSibling, Node.NextSibling, Node.NodeValue, Node.TextContent, EventTarget.AddEventListener(string, DOMEventHandler, bool), EventTarget.AddEventListener(string, IEventListener), EventTarget.AddEventListener(string, IEventListener, bool), EventTarget.RemoveEventListener(string, DOMEventHandler, bool), EventTarget.RemoveEventListener(string, IEventListener), EventTarget.RemoveEventListener(string, IEventListener, bool), EventTarget.DispatchEvent(Event), EventTarget.Dispose(), EventTarget.Dispose(bool), DOMObject.GetPlatformType(), object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Construtores

Element(QualifiedName, Document)

Inicializa uma nova instância da classe Aspose.Html.Dom.Element. Não chame este construtor diretamente, use Aspose.Html.Dom.Document.CreateElement(System.String) ou Aspose.Html.Dom.Document.CreateElementNS(System.String,System.String).

public Element(QualifiedName qualifiedName, Document document)

Parâmetros

qualifiedName QualifiedName

O nome qualificado.

document Document

O documento associado.

Propriedades

Attributes

Um NamedNodeMap contendo os atributos deste nó (se for um Element) ou nulo caso contrário.

[DOMName("attributes")]
public NamedNodeMap Attributes { get; }

Valor da Propriedade

NamedNodeMap

ChildElementCount

Retorna o número atual de nós de elemento que são filhos deste elemento. 0 se este elemento não tiver nós filhos que sejam do nodeType 1.

public int ChildElementCount { get; }

Valor da Propriedade

int

Children

Retorna os elementos filhos do elemento atual.

public HTMLCollection Children { get; }

Valor da Propriedade

HTMLCollection

ClassList

Retorna um DOMTokenList ao vivo que contém tokens recebidos da análise do atributo “class”.

[DOMName("classList")]
public DOMTokenList ClassList { get; }

Valor da Propriedade

DOMTokenList

ClassName

O atributo de classe do elemento. Este atributo foi renomeado devido a conflitos com a palavra-chave “class” exposta por muitas linguagens. Veja a definição do atributo class no HTML 4.01.

[DOMName("className")]
public string ClassName { get; set; }

Valor da Propriedade

string

FirstElementChild

Retorna o primeiro nó de elemento filho deste elemento. nulo se este elemento não tiver elementos filhos.

public Element FirstElementChild { get; }

Valor da Propriedade

Element

Id

O identificador do elemento. Veja a definição do atributo id no HTML 4.01.

[DOMName("id")]
public string Id { get; set; }

Valor da Propriedade

string

InnerHTML

Retorna um fragmento de HTML ou XML que representa o conteúdo do elemento. Pode ser definido para substituir o conteúdo do elemento por nós analisados a partir da string dada.

[DOMName("innerHTML")]
public string InnerHTML { get; set; }

Valor da Propriedade

string

LastElementChild

Retorna o último nó de elemento filho deste elemento. nulo se este elemento não tiver elementos filhos.

public Element LastElementChild { get; }

Valor da Propriedade

Element

LocalName

Retorna a parte local do nome qualificado deste nó. Para nós de qualquer tipo diferente de ELEMENT_NODE e ATTRIBUTE_NODE e nós criados com um método DOM Level 1, como Document.createElement(), isso é sempre nulo.

public override string LocalName { get; }

Valor da Propriedade

string

NamespaceURI

O URI do namespace deste nó, ou nulo se não estiver especificado.

[DOMNullable]
[DOMName("namespaceURI")]
public override string NamespaceURI { get; }

Valor da Propriedade

string

NextElementSibling

Retorna o próximo nó de elemento irmão deste elemento. nulo se este elemento não tiver nós irmãos de elemento que venham após este na árvore do documento.

public Element NextElementSibling { get; }

Valor da Propriedade

Element

NodeName

O nome deste nó, dependendo de seu tipo.

public override string NodeName { get; }

Valor da Propriedade

string

NodeType

Um código que representa o tipo do objeto subjacente.

public override ushort NodeType { get; }

Valor da Propriedade

ushort

OuterHTML

Retorna um fragmento de HTML ou XML que representa o elemento e seu conteúdo. Pode ser definido para substituir o elemento por nós analisados a partir da string dada.

[DOMName("outerHTML")]
public string OuterHTML { get; set; }

Valor da Propriedade

string

Prefix

O prefixo do namespace deste nó, ou nulo se não estiver especificado. Quando definido como nulo, defini-lo não tem efeito.

[DOMNullable]
[DOMName("prefix")]
public override string Prefix { get; }

Valor da Propriedade

string

PreviousElementSibling

Retorna o nó de elemento irmão anterior deste elemento. nulo se este elemento não tiver nós irmãos de elemento que venham antes deste na árvore do documento.

public Element PreviousElementSibling { get; }

Valor da Propriedade

Element

ShadowRoot

Retorna o shadowRoot armazenado neste elemento ou nulo se estiver fechado.

[DOMName("shadowRoot")]
public ShadowRoot ShadowRoot { get; }

Valor da Propriedade

ShadowRoot

TagName

O nome do elemento.

[DOMName("tagName")]
public string TagName { get; }

Valor da Propriedade

string

TextContent

Este atributo retorna o conteúdo de texto deste nó e seus descendentes. Quando definido como nulo, defini-lo não tem efeito. Ao definir, quaisquer possíveis filhos que este nó possa ter são removidos e, se a nova string não estiver vazia ou nula, são substituídos por um único nó de Texto contendo a string que este atributo é definido.

public override string TextContent { get; set; }

Valor da Propriedade

string

Métodos

AttachShadow(ShadowRootMode)

Cria o shadow root e o anexa ao elemento atual.

[DOMName("attachShadow")]
public ShadowRoot AttachShadow(ShadowRootMode mode)

Parâmetros

mode ShadowRootMode

Modo em que o shadow root será criado.

Retornos

ShadowRoot

ShadowRoot criado.

Exceções

NotSupportedError: O elemento não suporta a árvore de sombra.

InvalidStateError: O elemento já possui uma árvore de sombra.

Dispose(bool)

Libera recursos não gerenciados e - opcionalmente - gerenciados.

protected override void Dispose(bool disposing)

Parâmetros

disposing bool

true para liberar recursos gerenciados e não gerenciados; false para liberar apenas recursos não gerenciados.

GetAttribute(string)

Recupera um valor de atributo pelo nome.

[DOMNullable]
[DOMName("getAttribute")]
public string GetAttribute(string qualifiedName)

Parâmetros

qualifiedName string

O nome do atributo a ser recuperado.

Retornos

string

Retorna o valor do atributo.

GetAttributeNS(string, string)

Recupera um valor de atributo pelo nome local e URI do namespace.

[DOMNullable]
[DOMName("getAttributeNS")]
public string GetAttributeNS(string namespaceURI, string localName)

Parâmetros

namespaceURI string

O URI do namespace.

localName string

Nome do local.

Retornos

string

Retorna o atributo.

GetAttributeNames()

Retorna os nomes dos atributos do elemento como um Array de strings. Se o elemento não tiver atributos, retorna um array vazio.

[DOMName("getAttributeNames")]
public string[] GetAttributeNames()

Retornos

string[]

Array de strings que representa os nomes dos atributos.

GetAttributeNode(string)

Recupera um nó de atributo pelo nome.

[DOMName("getAttributeNode")]
public Attr GetAttributeNode(string qualifiedName)

Parâmetros

qualifiedName string

O nome do atributo.

Retornos

Attr

Retorna o valor do atributo.

GetAttributeNodeNS(string, string)

Recupera um nó Attr pelo nome local e URI do namespace.

[DOMName("getAttributeNodeNS")]
public Attr GetAttributeNodeNS(string namespaceURI, string localName)

Parâmetros

namespaceURI string

O URI do namespace.

localName string

Nome do local.

Retornos

Attr

Retorna o atributo.

GetElementsByClassName(string)

Retorna um objeto NodeList ao vivo contendo todos os elementos no documento que possuem todas as classes especificadas no argumento.
http://www.w3.org/TR/dom/

[DOMName("getElementsByClassName")]
public HTMLCollection GetElementsByClassName(string classNames)

Parâmetros

classNames string

A string que contém um conjunto não ordenado de tokens únicos separados por espaço representando classes (nomes de classe).

Retornos

HTMLCollection

O Aspose.Html.Dom.Element.

GetElementsByTagName(string)

Retorna um NodeList de todos os Elementos descendentes com um nome de tag dado, na ordem do documento.

[DOMName("getElementsByTagName")]
public HTMLCollection GetElementsByTagName(string name)

Parâmetros

name string

O nome da tag.

Retornos

HTMLCollection

Retorna o atributo.

GetElementsByTagNameNS(string, string)

Retorna um NodeList de todos os Elementos descendentes com um nome local e URI do namespace dados na ordem do documento.

[DOMName("getElementsByTagNameNS")]
public HTMLCollection GetElementsByTagNameNS(string namespaceURI, string localName)

Parâmetros

namespaceURI string

O URI do namespace.

localName string

Nome do local.

Retornos

HTMLCollection

Retorna os elementos.

HasAttribute(string)

Retorna verdadeiro quando um atributo com um nome dado está especificado neste elemento ou tem um valor padrão, falso caso contrário.

[DOMName("hasAttribute")]
public bool HasAttribute(string qualifiedName)

Parâmetros

qualifiedName string

O nome do atributo.

Retornos

bool

true se o nome especificado tem atributo; caso contrário, false.

HasAttributeNS(string, string)

Retorna verdadeiro quando um atributo com um nome local dado e URI do namespace está especificado neste elemento ou tem um valor padrão, falso caso contrário.

[DOMName("hasAttributeNS")]
public bool HasAttributeNS(string namespaceURI, string localName)

Parâmetros

namespaceURI string

O URI do namespace.

localName string

Nome do local.

Retornos

bool

true se [tem atributo NS] [o URI do namespace especificado]; caso contrário, false.

HasAttributes()

Retorna se este nó (se for um elemento) tem atributos.

[DOMName("hasAttributes")]
public bool HasAttributes()

Retornos

bool

booleano true se este nó tem atributos, false caso contrário.

QuerySelector(string)

Retorna o primeiro Elemento no documento que corresponde ao seletor.

public Element QuerySelector(string selector)

Parâmetros

selector string

O seletor.

Retornos

Element

O elemento correspondente.

QuerySelectorAll(string)

Retorna um NodeList de todos os Elementos no documento que correspondem ao seletor.

public NodeList QuerySelectorAll(string selector)

Parâmetros

selector string

O seletor.

Retornos

NodeList

Aspose.Html.Collections.HTMLCollection

Remove()

Remove esta instância.

public void Remove()

RemoveAttribute(string)

Remove um atributo pelo nome.

[DOMName("removeAttribute")]
public void RemoveAttribute(string qualifiedName)

Parâmetros

qualifiedName string

O nome do atributo.

RemoveAttributeNS(string, string)

Remove um atributo pelo nome local e URI do namespace.

[DOMName("removeAttributeNS")]
public void RemoveAttributeNS(string namespaceURI, string localName)

Parâmetros

namespaceURI string

O URI do namespace.

localName string

Nome do local.

RemoveAttributeNode(Attr)

Remove o nó de atributo especificado.

[DOMName("removeAttributeNode")]
public Attr RemoveAttributeNode(Attr oldAttr)

Parâmetros

oldAttr Attr

O antigo attr.

Retornos

Attr

Retorna o atributo.

SetAttribute(string, string)

Adiciona um novo atributo. Se um atributo com esse nome já estiver presente no elemento, seu valor é alterado para o valor do parâmetro value.

[DOMName("setAttribute")]
public void SetAttribute(string qualifiedName, string value)

Parâmetros

qualifiedName string

O nome do atributo.

value string

O valor.

SetAttributeNS(string, string, string)

Adiciona um novo atributo. Se um atributo com o mesmo nome local e URI do namespace já estiver presente no elemento, seu prefixo é alterado para ser a parte do prefixo do qualifiedName, e seu valor é alterado para ser o parâmetro value.

[DOMName("setAttributeNS")]
public void SetAttributeNS(string namespaceURI, string qualifiedName, string value)

Parâmetros

namespaceURI string

O URI do namespace.

qualifiedName string

Nome do qualificado.

value string

O valor.

SetAttributeNode(Attr)

Adiciona um novo nó de atributo. Se um atributo com esse nome (nodeName) já estiver presente no elemento, ele é substituído pelo novo.

[DOMName("setAttributeNode")]
public Attr SetAttributeNode(Attr newAttr)

Parâmetros

newAttr Attr

O novo attr.

Retornos

Attr

Retorna o atributo.

SetAttributeNodeNS(Attr)

Adiciona um novo atributo. Se um atributo com esse nome local e URI do namespace já estiver presente no elemento, ele é substituído pelo novo.

[DOMName("setAttributeNodeNS")]
public Attr SetAttributeNodeNS(Attr newAttr)

Parâmetros

newAttr Attr

O novo attr.

Retornos

Attr

Retorna o atributo.

ToggleAttribute(string)

Se a força não for dada, “alternar” qualifiedName, removendo-o se estiver presente e adicionando-o se não estiver presente. Se a força for verdadeira, adiciona qualifiedName. Se a força for falsa, remove qualifiedName.

[DOMName("toggleAttribute")]
public bool ToggleAttribute(string qualifiedName)

Parâmetros

qualifiedName string

O atributo QualifiedName.

Retornos

bool

Retorna verdadeiro se qualifiedName agora estiver presente; caso contrário, falso.

ToggleAttribute(string, bool)

Se a força não for dada, “alternar” qualifiedName, removendo-o se estiver presente e adicionando-o se não estiver presente. Se a força for verdadeira, adiciona qualifiedName. Se a força for falsa, remove qualifiedName.

[DOMName("toggleAttribute")]
public bool ToggleAttribute(string qualifiedName, bool force)

Parâmetros

qualifiedName string

O atributo QualifiedName.

force bool

A opção de força para alternar o atributo.

Retornos

bool

Retorna verdadeiro se qualifiedName agora estiver presente; caso contrário, falso.

 Português