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
object ← DOMObject ← EventTarget ← Node ← Element
Derivados
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
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
Children
Retorna os elementos filhos do elemento atual.
public HTMLCollection Children { get; }
Valor da Propriedade
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
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
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
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
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
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
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
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
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
NodeName
O nome deste nó, dependendo de seu tipo.
public override string NodeName { get; }
Valor da Propriedade
NodeType
Um código que representa o tipo do objeto subjacente.
public override ushort NodeType { get; }
Valor da Propriedade
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
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
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
ShadowRoot
Retorna o shadowRoot armazenado neste elemento ou nulo se estiver fechado.
[DOMName("shadowRoot")]
public ShadowRoot ShadowRoot { get; }
Valor da Propriedade
TagName
O nome do elemento.
[DOMName("tagName")]
public string TagName { get; }
Valor da Propriedade
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
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 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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
Retorna verdadeiro se qualifiedName agora estiver presente; caso contrário, falso.