Class Element

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

L’interfaccia Element rappresenta un elemento in un documento HTML o XML.

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

Ereditarietà

object ← DOMObject ← EventTarget ← Node ← Element

Derivato

HTMLElement, SVGElement

Implementa

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

Membri Ereditati

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

Costruttori

Element(QualifiedName, Document)

Inizializza una nuova istanza della classe Aspose.Html.Dom.Element. Non chiamare direttamente questo costruttore, utilizzare Aspose.Html.Dom.Document.CreateElement(System.String) o Aspose.Html.Dom.Document.CreateElementNS(System.String,System.String).

public Element(QualifiedName qualifiedName, Document document)

Parametri

qualifiedName QualifiedName

Il nome qualificato.

document Document

Il documento associato.

Proprietà

Attributes

Una NamedNodeMap contenente gli attributi di questo nodo (se è un Element) o null in caso contrario.

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

Valore della Proprietà

NamedNodeMap

ChildElementCount

Restituisce il numero attuale di nodi elemento che sono figli di questo elemento. 0 se questo elemento non ha nodi figli di nodeType 1.

public int ChildElementCount { get; }

Valore della Proprietà

int

Children

Restituisce gli elementi figli dell’elemento corrente.

public HTMLCollection Children { get; }

Valore della Proprietà

HTMLCollection

ClassList

Restituisce un DOMTokenList live che contiene i token ricevuti dal parsing dell’attributo “class”.

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

Valore della Proprietà

DOMTokenList

ClassName

L’attributo class dell’elemento. Questo attributo è stato rinominato a causa di conflitti con la parola chiave “class” esposta da molti linguaggi. Vedi la definizione dell’attributo class in HTML 4.01.

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

Valore della Proprietà

string

FirstElementChild

Restituisce il primo nodo elemento figlio di questo elemento. null se questo elemento non ha elementi figli.

public Element FirstElementChild { get; }

Valore della Proprietà

Element

Id

L’identificatore dell’elemento. Vedi la definizione dell’attributo id in HTML 4.01.

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

Valore della Proprietà

string

InnerHTML

Restituisce un frammento di HTML o XML che rappresenta il contenuto dell’elemento. Può essere impostato per sostituire il contenuto dell’elemento con nodi analizzati dalla stringa fornita.

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

Valore della Proprietà

string

LastElementChild

Restituisce l’ultimo nodo elemento figlio di questo elemento. null se questo elemento non ha elementi figli.

public Element LastElementChild { get; }

Valore della Proprietà

Element

LocalName

Restituisce la parte locale del nome qualificato di questo nodo. Per nodi di qualsiasi tipo diverso da ELEMENT_NODE e ATTRIBUTE_NODE e nodi creati con un metodo DOM Level 1, come Document.createElement(), questo è sempre null.

public override string LocalName { get; }

Valore della Proprietà

string

NamespaceURI

L’URI del namespace di questo nodo, o null se non specificato.

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

Valore della Proprietà

string

NextElementSibling

Restituisce il nodo elemento fratello successivo di questo elemento. null se questo elemento non ha nodi fratelli di tipo elemento che vengono dopo questo nell’albero del documento.

public Element NextElementSibling { get; }

Valore della Proprietà

Element

NodeName

Il nome di questo nodo, a seconda del suo tipo.

public override string NodeName { get; }

Valore della Proprietà

string

NodeType

Un codice che rappresenta il tipo dell’oggetto sottostante.

public override ushort NodeType { get; }

Valore della Proprietà

ushort

OuterHTML

Restituisce un frammento di HTML o XML che rappresenta l’elemento e i suoi contenuti. Può essere impostato per sostituire l’elemento con nodi analizzati dalla stringa fornita.

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

Valore della Proprietà

string

Prefix

Il prefisso del namespace di questo nodo, o null se non specificato. Quando è definito come null, impostarlo non ha effetto.

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

Valore della Proprietà

string

PreviousElementSibling

Restituisce il nodo elemento fratello precedente di questo elemento. null se questo elemento non ha nodi fratelli di tipo elemento che vengono prima di questo nell’albero del documento.

public Element PreviousElementSibling { get; }

Valore della Proprietà

Element

ShadowRoot

Restituisce shadowRoot memorizzato su questo elemento o null se è chiuso.

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

Valore della Proprietà

ShadowRoot

TagName

Il nome dell’elemento.

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

Valore della Proprietà

string

TextContent

Questo attributo restituisce il contenuto testuale di questo nodo e dei suoi discendenti. Quando è definito come null, impostarlo non ha effetto. Quando viene impostato, eventuali figli che questo nodo può avere vengono rimossi e, se la nuova stringa non è vuota o null, sostituiti da un singolo nodo di testo contenente la stringa a cui questo attributo è impostato.

public override string TextContent { get; set; }

Valore della Proprietà

string

Metodi

AttachShadow(ShadowRootMode)

Crea un shadow root e lo attacca all’elemento corrente.

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

Parametri

mode ShadowRootMode

Modalità in cui verrà creato lo shadow root.

Restituisce

ShadowRoot

Lo Aspose.Html.Dom.ShadowRoot creato.

Eccezioni

NotSupportedError: L’elemento non supporta l’albero shadow.

InvalidStateError: L’elemento ha già un albero shadow.

Dispose(bool)

Rilascia risorse non gestite e - opzionalmente - gestite.

protected override void Dispose(bool disposing)

Parametri

disposing bool

true per rilasciare sia risorse gestite che non gestite; false per rilasciare solo risorse non gestite.

GetAttribute(string)

Recupera un valore di attributo per nome.

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

Parametri

qualifiedName string

Il nome dell’attributo da recuperare.

Restituisce

string

Restituisce il valore dell’attributo.

GetAttributeNS(string, string)

Recupera un valore di attributo per nome locale e URI del namespace.

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

Parametri

namespaceURI string

L’URI del namespace.

localName string

Nome del locale.

Restituisce

string

Restituisce l’attributo.

GetAttributeNames()

Restituisce i nomi degli attributi dell’elemento come un array di stringhe. Se l’elemento non ha attributi, restituisce un array vuoto.

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

Restituisce

string[]

Array di stringhe che rappresentano i nomi degli attributi.

GetAttributeNode(string)

Recupera un nodo attributo per nome.

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

Parametri

qualifiedName string

Il nome dell’attributo.

Restituisce

Attr

Restituisce il valore dell’attributo.

GetAttributeNodeNS(string, string)

Recupera un nodo Attr per nome locale e URI del namespace.

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

Parametri

namespaceURI string

L’URI del namespace.

localName string

Nome del locale.

Restituisce

Attr

Restituisce l’attributo.

GetElementsByClassName(string)

Restituisce un oggetto NodeList live contenente tutti gli elementi nel documento che hanno tutte le classi specificate nell’argomento.
http://www.w3.org/TR/dom/

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

Parametri

classNames string

La stringa che contiene un insieme non ordinato di token unici separati da spazi che rappresentano classi (nomi di classi).

Restituisce

HTMLCollection

L’Aspose.Html.Dom.Element.

GetElementsByTagName(string)

Restituisce un NodeList di tutti gli elementi discendenti con un dato nome di tag, in ordine di documento.

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

Parametri

name string

Il nome del tag.

Restituisce

HTMLCollection

Restituisce l’attributo.

GetElementsByTagNameNS(string, string)

Restituisce un NodeList di tutti gli elementi discendenti con un dato nome locale e URI del namespace in ordine di documento.

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

Parametri

namespaceURI string

L’URI del namespace.

localName string

Nome del locale.

Restituisce

HTMLCollection

Restituisce gli elementi.

HasAttribute(string)

Restituisce true quando un attributo con un dato nome è specificato su questo elemento o ha un valore predefinito, false altrimenti.

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

Parametri

qualifiedName string

Il nome dell’attributo.

Restituisce

bool

true se il nome specificato ha un attributo; altrimenti, false.

HasAttributeNS(string, string)

Restituisce true quando un attributo con un dato nome locale e URI del namespace è specificato su questo elemento o ha un valore predefinito, false altrimenti.

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

Parametri

namespaceURI string

L’URI del namespace.

localName string

Nome del locale.

Restituisce

bool

true se [ha attributo NS] [l’URI del namespace specificato]; altrimenti, false.

HasAttributes()

Restituisce se questo nodo (se è un elemento) ha attributi.

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

Restituisce

bool

boolean true se questo nodo ha attributi, false altrimenti.

QuerySelector(string)

Restituisce il primo elemento nel documento che corrisponde al selettore.

public Element QuerySelector(string selector)

Parametri

selector string

Il selettore.

Restituisce

Element

L’elemento corrispondente.

QuerySelectorAll(string)

Restituisce un NodeList di tutti gli elementi nel documento che corrispondono al selettore.

public NodeList QuerySelectorAll(string selector)

Parametri

selector string

Il selettore.

Restituisce

NodeList

Aspose.Html.Collections.HTMLCollection.

Remove()

Rimuove questa istanza.

public void Remove()

RemoveAttribute(string)

Rimuove un attributo per nome.

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

Parametri

qualifiedName string

Il nome dell’attributo.

RemoveAttributeNS(string, string)

Rimuove un attributo per nome locale e URI del namespace.

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

Parametri

namespaceURI string

L’URI del namespace.

localName string

Nome del locale.

RemoveAttributeNode(Attr)

Rimuove il nodo attributo specificato.

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

Parametri

oldAttr Attr

Il vecchio attributo.

Restituisce

Attr

Restituisce l’attributo.

SetAttribute(string, string)

Aggiunge un nuovo attributo. Se un attributo con quel nome è già presente nell’elemento, il suo valore viene cambiato in quello del parametro value.

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

Parametri

qualifiedName string

Il nome dell’attributo.

value string

Il valore.

SetAttributeNS(string, string, string)

Aggiunge un nuovo attributo. Se un attributo con lo stesso nome locale e URI del namespace è già presente nell’elemento, il suo prefisso viene cambiato per essere la parte prefisso del nome qualificato, e il suo valore viene cambiato per essere il parametro value.

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

Parametri

namespaceURI string

L’URI del namespace.

qualifiedName string

Nome del qualificato.

value string

Il valore.

SetAttributeNode(Attr)

Aggiunge un nuovo nodo attributo. Se un attributo con quel nome (nodeName) è già presente nell’elemento, viene sostituito dal nuovo.

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

Parametri

newAttr Attr

Il nuovo attributo.

Restituisce

Attr

Restituisce l’attributo.

SetAttributeNodeNS(Attr)

Aggiunge un nuovo attributo. Se un attributo con quel nome locale e URI del namespace è già presente nell’elemento, viene sostituito dal nuovo.

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

Parametri

newAttr Attr

Il nuovo attributo.

Restituisce

Attr

Restituisce l’attributo.

ToggleAttribute(string)

Se non viene fornito il forzo, “attiva” qualifiedName, rimuovendolo se è presente e aggiungendolo se non è presente. Se il forzo è true, aggiunge qualifiedName. Se il forzo è false, rimuove qualifiedName.

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

Parametri

qualifiedName string

Il nome qualificato dell’attributo.

Restituisce

bool

Restituisce true se qualifiedName è ora presente; altrimenti false.

ToggleAttribute(string, bool)

Se non viene fornito il forzo, “attiva” qualifiedName, rimuovendolo se è presente e aggiungendolo se non è presente. Se il forzo è true, aggiunge qualifiedName. Se il forzo è false, rimuove qualifiedName.

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

Parametri

qualifiedName string

Il nome qualificato dell’attributo.

force bool

L’opzione di forzare l’attributo da attivare.

Restituisce

bool

Restituisce true se qualifiedName è ora presente; altrimenti false.