Class Element
Namespace: Aspose.Html.Dom
Assembly: Aspose.HTML.dll (25.1.0)
Інтерфейс Element представляє елемент у документі HTML або XML.
[ComVisible(true)]
[DOMObject]
[DOMName("Element")]
public class Element : Node, INotifyPropertyChanged, IEventTarget, IDisposable, IXPathNSResolver, IParentNode, IElementTraversal, IChildNodeСпадкування
object ← DOMObject ← EventTarget ← Node ← Element
Похідні
Реалізує
INotifyPropertyChanged, IEventTarget, IDisposable, IXPathNSResolver, IParentNode, IElementTraversal, IChildNode
Спадковані члени
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()
Конструктори
Element(QualifiedName, Document)
Ініціалізує новий екземпляр класу Aspose.Html.Dom.Element. Не викликайте цей конструктор безпосередньо, використовуйте Aspose.Html.Dom.Document.CreateElement(System.String) або Aspose.Html.Dom.Document.CreateElementNS(System.String,System.String).
public Element(QualifiedName qualifiedName, Document document)Параметри
qualifiedName QualifiedName
Кваліфіковане ім’я.
document Document
Пов’язаний документ.
Властивості
Attributes
NamedNodeMap, що містить атрибути цього вузла (якщо це елемент) або null в іншому випадку.
[DOMName("attributes")]
public NamedNodeMap Attributes { get; }Значення властивості
ChildElementCount
Повертає поточну кількість вузлів-елементів, які є нащадками цього елемента. 0, якщо цей елемент не має дочірніх вузлів типу nodeType 1.
public int ChildElementCount { get; }Значення властивості
Children
Повертає дочірні елементи поточного елемента.
public HTMLCollection Children { get; }Значення властивості
ClassList
Повертає живий DOMTokenList, який містить токени, отримані з парсингу атрибута “class”.
[DOMName("classList")]
public DOMTokenList ClassList { get; }Значення властивості
ClassName
Атрибут класу елемента. Цей атрибут був перейменований через конфлікти з ключовим словом “class”, яке використовується в багатьох мовах. Див. визначення атрибута класу в HTML 4.01.
[DOMName("className")]
public string ClassName { get; set; }Значення властивості
FirstElementChild
Повертає перший дочірній вузол-елемент цього елемента. null, якщо цей елемент не має дочірніх елементів.
public Element FirstElementChild { get; }Значення властивості
Id
Ідентифікатор елемента. Див. визначення атрибута id в HTML 4.01.
[DOMName("id")]
public string Id { get; set; }Значення властивості
InnerHTML
Повертає фрагмент HTML або XML, що представляє вміст елемента. Може бути заданий, щоб замінити вміст елемента вузлами, розібраними з даного рядка.
[DOMName("innerHTML")]
public string InnerHTML { get; set; }Значення властивості
LastElementChild
Повертає останній дочірній вузол-елемент цього елемента. null, якщо цей елемент не має дочірніх елементів.
public Element LastElementChild { get; }Значення властивості
LocalName
Повертає локальну частину кваліфікованого імені цього вузла. Для вузлів будь-якого типу, крім ELEMENT_NODE і ATTRIBUTE_NODE, а також вузлів, створених за допомогою методу DOM Level 1, такого як Document.createElement(), це завжди null.
public override string LocalName { get; }Значення властивості
NamespaceURI
URI простору імен цього вузла або null, якщо він не вказаний.
[DOMNullable]
[DOMName("namespaceURI")]
public override string NamespaceURI { get; }Значення властивості
NextElementSibling
Повертає наступний сусідній вузол-елемент цього елемента. null, якщо цей елемент не має сусідніх вузлів-елементів, які йдуть після цього в дереві документа.
public Element NextElementSibling { get; }Значення властивості
NodeName
Ім’я цього вузла, в залежності від його типу.
public override string NodeName { get; }Значення властивості
NodeType
Код, що представляє тип основного об’єкта.
public override ushort NodeType { get; }Значення властивості
OuterHTML
Повертає фрагмент HTML або XML, що представляє елемент і його вміст. Може бути заданий, щоб замінити елемент вузлами, розібраними з даного рядка.
[DOMName("outerHTML")]
public string OuterHTML { get; set; }Значення властивості
Prefix
Префікс простору імен цього вузла або null, якщо він не вказаний. Коли він визначений як null, його встановлення не має ефекту.
[DOMNullable]
[DOMName("prefix")]
public override string Prefix { get; }Значення властивості
PreviousElementSibling
Повертає попередній сусідній вузол-елемент цього елемента. null, якщо цей елемент не має сусідніх вузлів-елементів, які йдуть перед цим в дереві документа.
public Element PreviousElementSibling { get; }Значення властивості
ShadowRoot
Повертає shadowRoot, збережений на цьому елементі, або null, якщо він закритий.
[DOMName("shadowRoot")]
public ShadowRoot ShadowRoot { get; }Значення властивості
TagName
Ім’я елемента.
[DOMName("tagName")]
public string TagName { get; }Значення властивості
TextContent
Цей атрибут повертає текстовий вміст цього вузла та його нащадків. Коли він визначений як null, його встановлення не має ефекту. При встановленні будь-які можливі нащадки цього вузла видаляються, і, якщо новий рядок не є порожнім або null, замінюються єдиним текстовим вузлом, що містить рядок, до якого цей атрибут встановлюється.
public override string TextContent { get; set; }Значення властивості
Методи
AttachShadow(ShadowRootMode)
Створює shadow root і приєднує його до поточного елемента.
[DOMName("attachShadow")]
public ShadowRoot AttachShadow(ShadowRootMode mode)Параметри
mode ShadowRootMode
Режим, в якому буде створено shadow root.
Повертає
Створений Aspose.Html.Dom.ShadowRoot.
Винятки
NotSupportedError: Елемент не підтримує дерево тіней.
InvalidStateError: Елемент вже має дерево тіней.
Dispose(bool)
Звільняє некеровані та - за бажанням - керовані ресурси.
protected override void Dispose(bool disposing)Параметри
disposing bool
true для звільнення як керованих, так і некерованих ресурсів; false для звільнення лише некерованих ресурсів.
GetAttribute(string)
Отримує значення атрибута за ім’ям.
[DOMNullable]
[DOMName("getAttribute")]
public string GetAttribute(string qualifiedName)Параметри
qualifiedName string
Ім’я атрибута для отримання.
Повертає
Повертає значення атрибута.
GetAttributeNS(string, string)
Отримує значення атрибута за локальним ім’ям і URI простору імен.
[DOMNullable]
[DOMName("getAttributeNS")]
public string GetAttributeNS(string namespaceURI, string localName)Параметри
namespaceURI string
URI простору імен.
localName string
Ім’я локального.
Повертає
Повертає атрибут.
GetAttributeNames()
Повертає імена атрибутів елемента у вигляді масиву рядків. Якщо елемент не має атрибутів, повертає порожній масив.
[DOMName("getAttributeNames")]
public string[] GetAttributeNames()Повертає
string[]
Масив рядків, що представляє імена атрибутів.
GetAttributeNode(string)
Отримує вузол атрибута за ім’ям.
[DOMName("getAttributeNode")]
public Attr GetAttributeNode(string qualifiedName)Параметри
qualifiedName string
Ім’я атрибута.
Повертає
Повертає значення атрибута.
GetAttributeNodeNS(string, string)
Отримує вузол Attr за локальним ім’ям і URI простору імен.
[DOMName("getAttributeNodeNS")]
public Attr GetAttributeNodeNS(string namespaceURI, string localName)Параметри
namespaceURI string
URI простору імен.
localName string
Ім’я локального.
Повертає
Повертає атрибут.
GetElementsByClassName(string)
Повертає живий об’єкт NodeList, що містить усі елементи в документі, які мають усі класи, зазначені в аргументі. http://www.w3.org/TR/dom/
[DOMName("getElementsByClassName")]
public HTMLCollection GetElementsByClassName(string classNames)Параметри
classNames string
Рядок, що містить незакінчений набір унікальних токенів, розділених пробілами, що представляють класи (імена класів).
Повертає
Елемент Aspose.Html.Dom.Element.
GetElementsByTagName(string)
Повертає NodeList усіх нащадків елементів з даним ім’ям тегу, у порядку документа.
[DOMName("getElementsByTagName")]
public HTMLCollection GetElementsByTagName(string name)Параметри
name string
Ім’я тегу.
Повертає
Повертає атрибут.
GetElementsByTagNameNS(string, string)
Повертає NodeList усіх нащадків елементів з даним локальним ім’ям і URI простору імен у порядку документа.
[DOMName("getElementsByTagNameNS")]
public HTMLCollection GetElementsByTagNameNS(string namespaceURI, string localName)Параметри
namespaceURI string
URI простору імен.
localName string
Ім’я локального.
Повертає
Повертає елементи.
HasAttribute(string)
Повертає true, коли атрибут з даним ім’ям вказано на цьому елементі або має значення за замовчуванням, false в іншому випадку.
[DOMName("hasAttribute")]
public bool HasAttribute(string qualifiedName)Параметри
qualifiedName string
Ім’я атрибута.
Повертає
true, якщо вказане ім’я має атрибут; в іншому випадку false.
HasAttributeNS(string, string)
Повертає true, коли атрибут з даним локальним ім’ям і URI простору імен вказано на цьому елементі або має значення за замовчуванням, false в іншому випадку.
[DOMName("hasAttributeNS")]
public bool HasAttributeNS(string namespaceURI, string localName)Параметри
namespaceURI string
URI простору імен.
localName string
Ім’я локального.
Повертає
true, якщо [має атрибут NS] [вказаний URI простору імен]; в іншому випадку false.
HasAttributes()
Повертає, чи має цей вузол (якщо це елемент) будь-які атрибути.
[DOMName("hasAttributes")]
public bool HasAttributes()Повертає
логічне true, якщо цей вузол має будь-які атрибути, false в іншому випадку.
QuerySelector(string)
Повертає перший елемент у документі, який відповідає селектору.
public Element QuerySelector(string selector)Параметри
selector string
Селектор.
Повертає
Відповідний елемент.
QuerySelectorAll(string)
Повертає NodeList усіх елементів у документі, які відповідають селектору.
public NodeList QuerySelectorAll(string selector)Параметри
selector string
Селектор.
Повертає
Aspose.Html.Collections.HTMLCollection.
Remove()
Видаляє цей екземпляр.
public void Remove()RemoveAttribute(string)
Видаляє атрибут за ім’ям.
[DOMName("removeAttribute")]
public void RemoveAttribute(string qualifiedName)Параметри
qualifiedName string
Ім’я атрибута.
RemoveAttributeNS(string, string)
Видаляє атрибут за локальним ім’ям і URI простору імен.
[DOMName("removeAttributeNS")]
public void RemoveAttributeNS(string namespaceURI, string localName)Параметри
namespaceURI string
URI простору імен.
localName string
Ім’я локального.
RemoveAttributeNode(Attr)
Видаляє вказаний вузол атрибута.
[DOMName("removeAttributeNode")]
public Attr RemoveAttributeNode(Attr oldAttr)Параметри
oldAttr Attr
Старий атрибут.
Повертає
Повертає атрибут.
SetAttribute(string, string)
Додає новий атрибут. Якщо атрибут з таким ім’ям вже присутній в елементі, його значення змінюється на значення параметра value.
[DOMName("setAttribute")]
public void SetAttribute(string qualifiedName, string value)Параметри
qualifiedName string
Ім’я атрибута.
value string
Значення.
SetAttributeNS(string, string, string)
Додає новий атрибут. Якщо атрибут з тим же локальним ім’ям і URI простору імен вже присутній на елементі, його префікс змінюється на частину префікса кваліфікованого імені, а його значення змінюється на значення параметра value.
[DOMName("setAttributeNS")]
public void SetAttributeNS(string namespaceURI, string qualifiedName, string value)Параметри
namespaceURI string
URI простору імен.
qualifiedName string
Ім’я кваліфікованого.
value string
Значення.
SetAttributeNode(Attr)
Додає новий вузол атрибута. Якщо атрибут з таким ім’ям (nodeName) вже присутній в елементі, він замінюється новим.
[DOMName("setAttributeNode")]
public Attr SetAttributeNode(Attr newAttr)Параметри
newAttr Attr
Новий атрибут.
Повертає
Повертає атрибут.
SetAttributeNodeNS(Attr)
Додає новий атрибут. Якщо атрибут з таким локальним ім’ям і URI простору імен вже присутній в елементі, він замінюється новим.
[DOMName("setAttributeNodeNS")]
public Attr SetAttributeNodeNS(Attr newAttr)Параметри
newAttr Attr
Новий атрибут.
Повертає
Повертає атрибут.
ToggleAttribute(string)
Якщо force не задано, “перемикає” qualifiedName, видаляючи його, якщо він присутній, і додаючи його, якщо він відсутній. Якщо force істинно, додає qualifiedName. Якщо force хибно, видаляє qualifiedName.
[DOMName("toggleAttribute")]
public bool ToggleAttribute(string qualifiedName)Параметри
qualifiedName string
Кваліфіковане ім’я атрибута.
Повертає
Повертає true, якщо qualifiedName тепер присутній; в іншому випадку false.
ToggleAttribute(string, bool)
Якщо force не задано, “перемикає” qualifiedName, видаляючи його, якщо він присутній, і додаючи його, якщо він відсутній. Якщо force істинно, додає qualifiedName. Якщо force хибно, видаляє qualifiedName.
[DOMName("toggleAttribute")]
public bool ToggleAttribute(string qualifiedName, bool force)Параметри
qualifiedName string
Кваліфіковане ім’я атрибута.
force bool
Опція примусу для перемикання атрибута.
Повертає
Повертає true, якщо qualifiedName тепер присутній; в іншому випадку false.
