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
object ← DOMObject ← EventTarget ← Node ← Element
Dérivé
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é
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é
Children
Renvoie les éléments enfants de l’élément actuel.
public HTMLCollection Children { get; }
Valeur de propriété
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é
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é
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é
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é
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é
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é
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é
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é
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é
NodeName
Le nom de ce nœud, en fonction de son type.
public override string NodeName { get; }
Valeur de propriété
NodeType
Un code représentant le type de l’objet sous-jacent.
public override ushort NodeType { get; }
Valeur de propriété
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é
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é
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é
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é
TagName
Le nom de l’élément.
[DOMName("tagName")]
public string TagName { get; }
Valeur de propriété
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é
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 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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
Renvoie true si qualifiedName est maintenant présent ; sinon false.