Class Element

Class Element

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

L’interface Element représente un élément dans un document HTML ou XML.

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

Héritage

objectDOMObjectEventTargetNodeElement

Dérivé

HTMLElement, SVGElement

Implémente

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

Membres hérités

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

Constructeurs

Element(QualifiedName, Document)

Initialise une nouvelle instance de la classe Aspose.Html.Dom.Element. Ne pas appeler ce constructeur directement, utilisez Aspose.Html.Dom.Document.CreateElement(System.String) ou Aspose.Html.Dom.Document.CreateElementNS(System.String,System.String).

public Element(QualifiedName qualifiedName, Document document)

Paramètres

qualifiedName QualifiedName

Le nom qualifié.

document Document

Le document associé.

Propriétés

Attributes

Un NamedNodeMap contenant les attributs de ce nœud (s’il s’agit d’un élément) ou null sinon.

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

Valeur de propriété

NamedNodeMap

ChildElementCount

Renvoie le nombre actuel de nœuds élément qui sont des enfants de cet élément. 0 si cet élément n’a pas de nœuds enfants de type nodeType 1.

public int ChildElementCount { get; }

Valeur de propriété

int

Children

Renvoie les éléments enfants de l’élément actuel.

public HTMLCollection Children { get; }

Valeur de propriété

HTMLCollection

ClassList

Renvoie une DOMTokenList en direct qui contient des jetons reçus par l’analyse de l’attribut “class”.

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

Valeur de propriété

DOMTokenList

ClassName

L’attribut de classe de l’élément. Cet attribut a été renommé en raison de conflits avec le mot-clé “class” exposé par de nombreux langages. Voir la définition de l’attribut de classe dans HTML 4.01.

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

Valeur de propriété

string

FirstElementChild

Renvoie le premier nœud élément enfant de cet élément. null si cet élément n’a pas d’éléments enfants.

public Element FirstElementChild { get; }

Valeur de propriété

Element

Id

L’identifiant de l’élément. Voir la définition de l’attribut id dans HTML 4.01.

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

Valeur de propriété

string

InnerHTML

Renvoie un fragment de HTML ou XML qui représente le contenu de l’élément. Peut être défini pour remplacer le contenu de l’élément par des nœuds analysés à partir de la chaîne donnée.

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

Valeur de propriété

string

LastElementChild

Renvoie le dernier nœud élément enfant de cet élément. null si cet élément n’a pas d’éléments enfants.

public Element LastElementChild { get; }

Valeur de propriété

Element

LocalName

Renvoie la partie locale du nom qualifié de ce nœud. Pour les nœuds de tout type autre que ELEMENT_NODE et ATTRIBUTE_NODE et les nœuds créés avec une méthode de niveau DOM 1, telle que Document.createElement(), ceci est toujours null.

public override string LocalName { get; }

Valeur de propriété

string

NamespaceURI

L’URI de l’espace de noms de ce nœud, ou null s’il n’est pas spécifié.

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

Valeur de propriété

string

NextElementSibling

Renvoie le nœud élément frère suivant de cet élément. null si cet élément n’a pas de nœuds frères élément qui viennent après celui-ci dans l’arbre du document.

public Element NextElementSibling { get; }

Valeur de propriété

Element

NodeName

Le nom de ce nœud, en fonction de son type.

public override string NodeName { get; }

Valeur de propriété

string

NodeType

Un code représentant le type de l’objet sous-jacent.

public override ushort NodeType { get; }

Valeur de propriété

ushort

OuterHTML

Renvoie un fragment de HTML ou XML qui représente l’élément et son contenu. Peut être défini pour remplacer l’élément par des nœuds analysés à partir de la chaîne donnée.

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

Valeur de propriété

string

Prefix

Le préfixe d’espace de noms de ce nœud, ou null s’il n’est pas spécifié. Lorsqu’il est défini comme null, le fait de le définir n’a aucun effet.

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

Valeur de propriété

string

PreviousElementSibling

Renvoie le nœud élément frère précédent de cet élément. null si cet élément n’a pas de nœuds frères élément qui viennent avant celui-ci dans l’arbre du document.

public Element PreviousElementSibling { get; }

Valeur de propriété

Element

ShadowRoot

Renvoie le shadowRoot stocké sur cet élément ou null s’il est fermé.

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

Valeur de propriété

ShadowRoot

TagName

Le nom de l’élément.

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

Valeur de propriété

string

TextContent

Cet attribut renvoie le contenu texte de ce nœud et de ses descendants. Lorsqu’il est défini comme null, le fait de le définir n’a aucun effet. Lors de la définition, tous les enfants possibles que ce nœud peut avoir sont supprimés et, si la nouvelle chaîne n’est pas vide ou null, remplacés par un seul nœud de texte contenant la chaîne à laquelle cet attribut est défini.

public override string TextContent { get; set; }

Valeur de propriété

string

Méthodes

AttachShadow(ShadowRootMode)

Crée un shadow root et l’attache à l’élément actuel.

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

Paramètres

mode ShadowRootMode

Mode dans lequel le shadow root sera créé.

Renvoie

ShadowRoot

ShadowRoot Aspose.Html.Dom créé.

Exceptions

NotSupportedError: L’élément ne prend pas en charge l’arbre d’ombre.

InvalidStateError: L’élément a déjà un arbre d’ombre.

Dispose(bool)

Libère les ressources non gérées et - éventuellement - gérées.

protected override void Dispose(bool disposing)

Paramètres

disposing bool

true pour libérer à la fois les ressources gérées et non gérées ; false pour libérer uniquement les ressources non gérées.

GetAttribute(string)

Récupère la valeur d’un attribut par son nom.

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

Paramètres

qualifiedName string

Le nom de l’attribut à récupérer.

Renvoie

string

Renvoie la valeur de l’attribut.

GetAttributeNS(string, string)

Récupère la valeur d’un attribut par son nom local et son URI d’espace de noms.

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

Paramètres

namespaceURI string

L’URI de l’espace de noms.

localName string

Nom du local.

Renvoie

string

Renvoie l’attribut.

GetAttributeNames()

Renvoie les noms des attributs de l’élément sous forme de tableau de chaînes. Si l’élément n’a pas d’attributs, il renvoie un tableau vide.

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

Renvoie

string[]

Tableau de chaînes représentant les noms des attributs.

GetAttributeNode(string)

Récupère un nœud d’attribut par son nom.

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

Paramètres

qualifiedName string

Le nom de l’attribut.

Renvoie

Attr

Renvoie la valeur de l’attribut.

GetAttributeNodeNS(string, string)

Récupère un nœud Attr par son nom local et son URI d’espace de noms.

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

Paramètres

namespaceURI string

L’URI de l’espace de noms.

localName string

Nom du local.

Renvoie

Attr

Renvoie l’attribut.

GetElementsByClassName(string)

Renvoie un objet NodeList en direct contenant tous les éléments dans le document qui ont toutes les classes spécifiées dans l’argument.
http://www.w3.org/TR/dom/

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

Paramètres

classNames string

La chaîne qui contient un ensemble non ordonné de jetons uniques séparés par des espaces représentant des classes (noms de classe).

Renvoie

HTMLCollection

L’Aspose.Html.Dom.Element.

GetElementsByTagName(string)

Renvoie une NodeList de tous les éléments descendants avec un nom de balise donné, dans l’ordre du document.

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

Paramètres

name string

Le nom de la balise.

Renvoie

HTMLCollection

Renvoie l’attribut.

GetElementsByTagNameNS(string, string)

Renvoie une NodeList de tous les éléments descendants avec un nom local donné et un URI d’espace de noms dans l’ordre du document.

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

Paramètres

namespaceURI string

L’URI de l’espace de noms.

localName string

Nom du local.

Renvoie

HTMLCollection

Renvoie les éléments.

HasAttribute(string)

Renvoie true lorsqu’un attribut avec un nom donné est spécifié sur cet élément ou a une valeur par défaut, false sinon.

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

Paramètres

qualifiedName string

Le nom de l’attribut.

Renvoie

bool

true si le nom spécifié a un attribut ; sinon, false.

HasAttributeNS(string, string)

Renvoie true lorsqu’un attribut avec un nom local donné et un URI d’espace de noms est spécifié sur cet élément ou a une valeur par défaut, false sinon.

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

Paramètres

namespaceURI string

L’URI de l’espace de noms.

localName string

Nom du local.

Renvoie

bool

true si [a un attribut NS] [l’URI d’espace de noms spécifié] ; sinon, false.

HasAttributes()

Renvoie si ce nœud (s’il s’agit d’un élément) a des attributs.

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

Renvoie

bool

boolean true si ce nœud a des attributs, false sinon.

QuerySelector(string)

Renvoie le premier élément dans le document qui correspond au sélecteur.

public Element QuerySelector(string selector)

Paramètres

selector string

Le sélecteur.

Renvoie

Element

L’élément correspondant.

QuerySelectorAll(string)

Renvoie une NodeList de tous les éléments dans le document qui correspondent au sélecteur.

public NodeList QuerySelectorAll(string selector)

Paramètres

selector string

Le sélecteur.

Renvoie

NodeList

Aspose.Html.Collections.HTMLCollection.

Remove()

Supprime cette instance.

public void Remove()

RemoveAttribute(string)

Supprime un attribut par son nom.

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

Paramètres

qualifiedName string

Le nom de l’attribut.

RemoveAttributeNS(string, string)

Supprime un attribut par son nom local et son URI d’espace de noms.

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

Paramètres

namespaceURI string

L’URI de l’espace de noms.

localName string

Nom du local.

RemoveAttributeNode(Attr)

Supprime le nœud d’attribut spécifié.

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

Paramètres

oldAttr Attr

L’ancien attr.

Renvoie

Attr

Renvoie l’attribut.

SetAttribute(string, string)

Ajoute un nouvel attribut. Si un attribut avec ce nom est déjà présent dans l’élément, sa valeur est changée pour être celle du paramètre value.

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

Paramètres

qualifiedName string

Le nom de l’attribut.

value string

La valeur.

SetAttributeNS(string, string, string)

Ajoute un nouvel attribut. Si un attribut avec le même nom local et l’URI d’espace de noms est déjà présent sur l’élément, son préfixe est changé pour être la partie préfixe du qualifiedName, et sa valeur est changée pour être celle du paramètre value.

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

Paramètres

namespaceURI string

L’URI de l’espace de noms.

qualifiedName string

Nom du qualifié.

value string

La valeur.

SetAttributeNode(Attr)

Ajoute un nouveau nœud d’attribut. Si un attribut avec ce nom (nodeName) est déjà présent dans l’élément, il est remplacé par le nouveau.

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

Paramètres

newAttr Attr

Le nouvel attr.

Renvoie

Attr

Renvoie l’attribut.

SetAttributeNodeNS(Attr)

Ajoute un nouvel attribut. Si un attribut avec ce nom local et cet URI d’espace de noms est déjà présent dans l’élément, il est remplacé par le nouveau.

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

Paramètres

newAttr Attr

Le nouvel attr.

Renvoie

Attr

Renvoie l’attribut.

ToggleAttribute(string)

Si force n’est pas donné, “bascule” qualifiedName, le supprimant s’il est présent et l’ajoutant s’il n’est pas présent. Si force est true, ajoute qualifiedName. Si force est false, supprime qualifiedName.

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

Paramètres

qualifiedName string

Le QualifiedName de l’attribut.

Renvoie

bool

Renvoie true si qualifiedName est maintenant présent ; sinon false.

ToggleAttribute(string, bool)

Si force n’est pas donné, “bascule” qualifiedName, le supprimant s’il est présent et l’ajoutant s’il n’est pas présent. Si force est true, ajoute qualifiedName. Si force est false, supprime qualifiedName.

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

Paramètres

qualifiedName string

Le QualifiedName de l’attribut.

force bool

L’option de force pour basculer l’attribut.

Renvoie

bool

Renvoie true si qualifiedName est maintenant présent ; sinon false.

 Français