Class Element

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

La interfaz Element representa un elemento en un documento HTML o XML.

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

Herencia

object ← DOMObject ← EventTarget ← Node ← Element

Derivados

HTMLElement, SVGElement

Implementa

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

Miembros heredados

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()

Constructores

Element(QualifiedName, Document)

Inicializa una nueva instancia de la clase Aspose.Html.Dom.Element. No llame a este constructor directamente, use Aspose.Html.Dom.Document.CreateElement(System.String) o Aspose.Html.Dom.Document.CreateElementNS(System.String,System.String).

public Element(QualifiedName qualifiedName, Document document)

Parámetros

qualifiedName QualifiedName

El nombre calificado.

document Document

El documento asociado.

Propiedades

Attributes

Un NamedNodeMap que contiene los atributos de este nodo (si es un Element) o null en caso contrario.

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

Valor de la propiedad

NamedNodeMap

ChildElementCount

Devuelve el número actual de nodos de elemento que son hijos de este elemento. 0 si este elemento no tiene nodos hijos que sean de nodeType 1.

public int ChildElementCount { get; }

Valor de la propiedad

int

Children

Devuelve los elementos hijos del elemento actual.

public HTMLCollection Children { get; }

Valor de la propiedad

HTMLCollection

ClassList

Devuelve un DOMTokenList en vivo que contiene los tokens recibidos al analizar el atributo “class”.

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

Valor de la propiedad

DOMTokenList

ClassName

El atributo de clase del elemento. Este atributo ha sido renombrado debido a conflictos con la palabra clave “class” expuesta por muchos lenguajes. Consulte la definición del atributo class en HTML 4.01.

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

Valor de la propiedad

string

FirstElementChild

Devuelve el primer nodo de elemento hijo de este elemento. null si este elemento no tiene elementos hijos.

public Element FirstElementChild { get; }

Valor de la propiedad

Element

Id

El identificador del elemento. Consulte la definición del atributo id en HTML 4.01.

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

Valor de la propiedad

string

InnerHTML

Devuelve un fragmento de HTML o XML que representa el contenido del elemento. Puede establecerse para reemplazar el contenido del elemento con nodos analizados desde la cadena dada.

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

Valor de la propiedad

string

LastElementChild

Devuelve el último nodo de elemento hijo de este elemento. null si este elemento no tiene elementos hijos.

public Element LastElementChild { get; }

Valor de la propiedad

Element

LocalName

Devuelve la parte local del nombre calificado de este nodo. Para nodos de cualquier tipo que no sean ELEMENT_NODE y ATTRIBUTE_NODE y nodos creados con un método del DOM de Nivel 1, como Document.createElement(), esto siempre es null.

public override string LocalName { get; }

Valor de la propiedad

string

NamespaceURI

La URI del espacio de nombres de este nodo, o null si no está especificado.

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

Valor de la propiedad

string

NextElementSibling

Devuelve el siguiente nodo de elemento hermano de este elemento. null si este elemento no tiene nodos hermanos de elemento que vengan después de este en el árbol del documento.

public Element NextElementSibling { get; }

Valor de la propiedad

Element

NodeName

El nombre de este nodo, dependiendo de su tipo.

public override string NodeName { get; }

Valor de la propiedad

string

NodeType

Un código que representa el tipo del objeto subyacente.

public override ushort NodeType { get; }

Valor de la propiedad

ushort

OuterHTML

Devuelve un fragmento de HTML o XML que representa el elemento y su contenido. Puede establecerse para reemplazar el elemento con nodos analizados desde la cadena dada.

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

Valor de la propiedad

string

Prefix

El prefijo del espacio de nombres de este nodo, o null si no está especificado. Cuando se define como null, establecerlo no tiene efecto.

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

Valor de la propiedad

string

PreviousElementSibling

Devuelve el nodo de elemento hermano anterior de este elemento. null si este elemento no tiene nodos hermanos de elemento que vengan antes de este en el árbol del documento.

public Element PreviousElementSibling { get; }

Valor de la propiedad

Element

ShadowRoot

Devuelve el shadowRoot almacenado en este elemento o null si está cerrado.

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

Valor de la propiedad

ShadowRoot

TagName

El nombre del elemento.

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

Valor de la propiedad

string

TextContent

Este atributo devuelve el contenido de texto de este nodo y sus descendientes. Cuando se define como null, establecerlo no tiene efecto. Al establecerlo, se eliminan los posibles hijos que este nodo pueda tener y, si la nueva cadena no está vacía o es null, se reemplazan por un único nodo de texto que contiene la cadena a la que se establece este atributo.

public override string TextContent { get; set; }

Valor de la propiedad

string

Métodos

AttachShadow(ShadowRootMode)

Crea un shadow root y lo adjunta al elemento actual.

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

Parámetros

mode ShadowRootMode

Modo en el que se creará el shadow root.

Devuelve

ShadowRoot

ShadowRoot de Aspose.Html.Dom creado.

Excepciones

NotSupportedError: El elemento no soporta el árbol de sombras.

InvalidStateError: El elemento ya tiene un árbol de sombras.

Dispose(bool)

Libera recursos no administrados y - opcionalmente - administrados.

protected override void Dispose(bool disposing)

Parámetros

disposing bool

true para liberar tanto recursos administrados como no administrados; false para liberar solo recursos no administrados.

GetAttribute(string)

Recupera el valor de un atributo por nombre.

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

Parámetros

qualifiedName string

El nombre del atributo a recuperar.

Devuelve

string

Devuelve el valor del atributo.

GetAttributeNS(string, string)

Recupera el valor de un atributo por nombre local y URI de espacio de nombres.

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

Parámetros

namespaceURI string

La URI del espacio de nombres.

localName string

Nombre del local.

Devuelve

string

Devuelve el atributo.

GetAttributeNames()

Devuelve los nombres de los atributos del elemento como un Array de cadenas. Si el elemento no tiene atributos, devuelve un array vacío.

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

Devuelve

string[]

Array de cadenas que representa los nombres de los atributos.

GetAttributeNode(string)

Recupera un nodo de atributo por nombre.

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

Parámetros

qualifiedName string

El nombre del atributo.

Devuelve

Attr

Devuelve el valor del atributo.

GetAttributeNodeNS(string, string)

Recupera un nodo Attr por nombre local y URI de espacio de nombres.

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

Parámetros

namespaceURI string

La URI del espacio de nombres.

localName string

Nombre del local.

Devuelve

Attr

Devuelve el atributo.

GetElementsByClassName(string)

Devuelve un objeto NodeList en vivo que contiene todos los elementos en el documento que tienen todas las clases especificadas en el argumento.
http://www.w3.org/TR/dom/

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

Parámetros

classNames string

La cadena que contiene un conjunto desordenado de tokens únicos separados por espacios que representan clases (nombres de clase).

Devuelve

HTMLCollection

El Aspose.Html.Dom.Element.

GetElementsByTagName(string)

Devuelve un NodeList de todos los elementos descendientes con un nombre de etiqueta dado, en orden de documento.

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

Parámetros

name string

El nombre de la etiqueta.

Devuelve

HTMLCollection

Devuelve el atributo.

GetElementsByTagNameNS(string, string)

Devuelve un NodeList de todos los elementos descendientes con un nombre local dado y URI de espacio de nombres en orden de documento.

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

Parámetros

namespaceURI string

La URI del espacio de nombres.

localName string

Nombre del local.

Devuelve

HTMLCollection

Devuelve los elementos.

HasAttribute(string)

Devuelve verdadero cuando un atributo con un nombre dado está especificado en este elemento o tiene un valor predeterminado, falso en caso contrario.

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

Parámetros

qualifiedName string

El nombre del atributo.

Devuelve

bool

true si el nombre especificado tiene atributo; de lo contrario, false.

HasAttributeNS(string, string)

Devuelve verdadero cuando un atributo con un nombre local dado y URI de espacio de nombres está especificado en este elemento o tiene un valor predeterminado, falso en caso contrario.

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

Parámetros

namespaceURI string

La URI del espacio de nombres.

localName string

Nombre del local.

Devuelve

bool

true si [tiene atributo NS] [la URI de espacio de nombres especificada]; de lo contrario, false.

HasAttributes()

Devuelve si este nodo (si es un elemento) tiene atributos.

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

Devuelve

bool

booleano true si este nodo tiene atributos, false en caso contrario.

QuerySelector(string)

Devuelve el primer Elemento en el documento que coincide con el selector.

public Element QuerySelector(string selector)

Parámetros

selector string

El selector.

Devuelve

Element

El elemento coincidente.

QuerySelectorAll(string)

Devuelve un NodeList de todos los Elementos en el documento que coinciden con el selector.

public NodeList QuerySelectorAll(string selector)

Parámetros

selector string

El selector.

Devuelve

NodeList

Aspose.Html.Collections.HTMLCollection.

Remove()

Elimina esta instancia.

public void Remove()

RemoveAttribute(string)

Elimina un atributo por nombre.

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

Parámetros

qualifiedName string

El nombre del atributo.

RemoveAttributeNS(string, string)

Elimina un atributo por nombre local y URI de espacio de nombres.

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

Parámetros

namespaceURI string

La URI del espacio de nombres.

localName string

Nombre del local.

RemoveAttributeNode(Attr)

Elimina el nodo de atributo especificado.

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

Parámetros

oldAttr Attr

El antiguo atributo.

Devuelve

Attr

Devuelve el atributo.

SetAttribute(string, string)

Agrega un nuevo atributo. Si ya hay un atributo con ese nombre presente en el elemento, su valor se cambia al del parámetro value.

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

Parámetros

qualifiedName string

El nombre del atributo.

value string

El valor.

SetAttributeNS(string, string, string)

Agrega un nuevo atributo. Si ya hay un atributo con el mismo nombre local y URI de espacio de nombres presente en el elemento, su prefijo se cambia al prefijo de qualifiedName y su valor se cambia al del parámetro value.

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

Parámetros

namespaceURI string

La URI del espacio de nombres.

qualifiedName string

Nombre del calificado.

value string

El valor.

SetAttributeNode(Attr)

Agrega un nuevo nodo de atributo. Si ya hay un atributo con ese nombre (nodeName) presente en el elemento, se reemplaza por el nuevo.

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

Parámetros

newAttr Attr

El nuevo atributo.

Devuelve

Attr

Devuelve el atributo.

SetAttributeNodeNS(Attr)

Agrega un nuevo atributo. Si ya hay un atributo con ese nombre local y URI de espacio de nombres presente en el elemento, se reemplaza por el nuevo.

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

Parámetros

newAttr Attr

El nuevo atributo.

Devuelve

Attr

Devuelve el atributo.

ToggleAttribute(string)

Si no se da fuerza, “alternará” qualifiedName, eliminándolo si está presente y agregándolo si no lo está. Si la fuerza es verdadera, agrega qualifiedName. Si la fuerza es falsa, elimina qualifiedName.

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

Parámetros

qualifiedName string

El QualifiedName del atributo.

Devuelve

bool

Devuelve verdadero si qualifiedName ahora está presente; de lo contrario, falso.

ToggleAttribute(string, bool)

Si no se da fuerza, “alternará” qualifiedName, eliminándolo si está presente y agregándolo si no lo está. Si la fuerza es verdadera, agrega qualifiedName. Si la fuerza es falsa, elimina qualifiedName.

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

Parámetros

qualifiedName string

El QualifiedName del atributo.

force bool

La opción de fuerza para alternar el atributo.

Devuelve

bool

Devuelve verdadero si qualifiedName ahora está presente; de lo contrario, falso.