Class Element

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

继承

objectDOMObjectEventTargetNodeElement

派生

HTMLElement, SVGElement

实现

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; }

属性值

NamedNodeMap

ChildElementCount

返回当前作为此元素子节点的元素节点数量。如果此元素没有子节点且节点类型为 1,则返回 0。

public int ChildElementCount { get; }

属性值

int

Children

返回当前元素的子元素。

public HTMLCollection Children { get; }

属性值

HTMLCollection

ClassList

返回一个实时的 DOMTokenList,其中包含从解析 “class” 属性中接收到的标记。

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

属性值

DOMTokenList

ClassName

元素的类属性。由于与许多语言暴露的 “class” 关键字发生冲突,因此此属性已被重命名。请参见 HTML 4.01 中的类属性定义。

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

属性值

string

FirstElementChild

返回此元素的第一个子元素节点。如果此元素没有子元素,则返回 null。

public Element FirstElementChild { get; }

属性值

Element

Id

元素的标识符。请参见 HTML 4.01 中的 id 属性定义。

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

属性值

string

InnerHTML

返回表示元素内容的 HTML 或 XML 片段。可以设置,以用从给定字符串解析的节点替换元素的内容。

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

属性值

string

LastElementChild

返回此元素的最后一个子元素节点。如果此元素没有子元素,则返回 null。

public Element LastElementChild { get; }

属性值

Element

LocalName

返回此节点的限定名的本地部分。对于除 ELEMENT_NODE 和 ATTRIBUTE_NODE 之外的任何类型的节点,以及使用 DOM Level 1 方法(例如 Document.createElement())创建的节点,这始终为 null。

public override string LocalName { get; }

属性值

string

NamespaceURI

此节点的命名空间 URI,如果未指定则为 null。

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

属性值

string

NextElementSibling

返回此元素的下一个兄弟元素节点。如果此元素在文档树中没有后续的兄弟元素节点,则返回 null。

public Element NextElementSibling { get; }

属性值

Element

NodeName

此节点的名称,取决于其类型。

public override string NodeName { get; }

属性值

string

NodeType

表示底层对象类型的代码。

public override ushort NodeType { get; }

属性值

ushort

OuterHTML

返回表示元素及其内容的 HTML 或 XML 片段。可以设置,以用从给定字符串解析的节点替换元素。

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

属性值

string

Prefix

此节点的命名空间前缀,如果未指定则为 null。当定义为 null 时,设置它没有效果。

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

属性值

string

PreviousElementSibling

返回此元素的前一个兄弟元素节点。如果此元素在文档树中没有前面的兄弟元素节点,则返回 null。

public Element PreviousElementSibling { get; }

属性值

Element

ShadowRoot

返回存储在此元素上的 shadowRoot,如果它是关闭的则为 null。

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

属性值

ShadowRoot

TagName

元素的名称。

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

属性值

string

TextContent

此属性返回此节点及其后代的文本内容。当定义为 null 时,设置它没有效果。在设置时,可能的任何子节点都将被移除,如果新字符串不为空或 null,则用包含此属性设置的字符串的单个文本节点替换。

public override string TextContent { get; set; }

属性值

string

方法

AttachShadow(ShadowRootMode)

创建 shadow root 并将其附加到当前元素。

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

参数

mode ShadowRootMode

将要创建的 shadow root 模式。

返回

ShadowRoot

创建的 Aspose.Html.Dom.ShadowRoot。

异常

NotSupportedError: 元素不支持 shadow tree。

InvalidStateError: 元素已经有 shadow tree。

Dispose(bool)

释放非托管和 - 可选 - 托管资源。

protected override void Dispose(bool disposing)

参数

disposing bool

true 释放托管和非托管资源; false 仅释放非托管资源。

GetAttribute(string)

通过名称检索属性值。

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

参数

qualifiedName string

要检索的属性名称。

返回

string

返回属性值

GetAttributeNS(string, string)

通过本地名称和命名空间 URI 检索属性值。

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

参数

namespaceURI string

命名空间 URI。

localName string

本地名称。

返回

string

返回属性

GetAttributeNames()

返回元素的属性名称作为字符串数组。如果元素没有属性,则返回空数组。

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

返回

string[]

表示属性名称的字符串数组。

GetAttributeNode(string)

通过名称检索属性节点。

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

参数

qualifiedName string

属性名称。

返回

Attr

返回属性值

GetAttributeNodeNS(string, string)

通过本地名称和命名空间 URI 检索 Attr 节点。

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

参数

namespaceURI string

命名空间 URI。

localName string

本地名称。

返回

Attr

返回属性

GetElementsByClassName(string)

返回一个实时的 NodeList 对象,包含文档中所有具有参数中指定的所有类的元素。 http://www.w3.org/TR/dom/

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

参数

classNames string

包含一组唯一的以空格分隔的标记(类名)的字符串。

返回

HTMLCollection

Aspose.Html.Dom.Element。

GetElementsByTagName(string)

返回所有具有给定标签名的后代元素的 NodeList,按文档顺序排列。

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

参数

name string

标签名。

返回

HTMLCollection

返回属性

GetElementsByTagNameNS(string, string)

返回具有给定本地名称和命名空间 URI 的所有后代元素的 NodeList,按文档顺序排列。

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

参数

namespaceURI string

命名空间 URI。

localName string

本地名称。

返回

HTMLCollection

返回元素

HasAttribute(string)

当此元素上指定具有给定名称的属性或具有默认值时,返回 true,否则返回 false。

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

参数

qualifiedName string

属性名称。

返回

bool

true 如果指定名称具有属性;否则,false

HasAttributeNS(string, string)

当此元素上指定具有给定本地名称和命名空间 URI 的属性或具有默认值时,返回 true,否则返回 false。

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

参数

namespaceURI string

命名空间 URI。

localName string

本地名称。

返回

bool

true 如果指定命名空间 URI 具有属性;否则,false

HasAttributes()

返回此节点(如果它是一个元素)是否具有任何属性。

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

返回

bool

布尔值 true 如果此节点具有任何属性,false 否则。

QuerySelector(string)

返回文档中第一个匹配选择器的元素。

public Element QuerySelector(string selector)

参数

selector string

选择器。

返回

Element

匹配的元素

QuerySelectorAll(string)

返回文档中所有匹配选择器的元素的 NodeList。

public NodeList QuerySelectorAll(string selector)

参数

selector string

选择器

返回

NodeList

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

旧属性。

返回

Attr

返回属性

SetAttribute(string, string)

添加新属性。如果元素中已经存在同名属性,则其值更改为值参数的值。

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

参数

qualifiedName string

属性名称。

value string

值。

SetAttributeNS(string, string, string)

添加新属性。如果元素中已经存在同一本地名称和命名空间 URI 的属性,则其前缀更改为 qualifiedName 的前缀部分,并且其值更改为值参数的值。

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

参数

namespaceURI string

命名空间 URI。

qualifiedName string

限定名称。

value string

值。

SetAttributeNode(Attr)

添加新属性节点。如果元素中已经存在同名属性(节点名称),则用新属性替换它。

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

参数

newAttr Attr

新属性。

返回

Attr

返回属性

SetAttributeNodeNS(Attr)

添加新属性。如果元素中已经存在同一本地名称和命名空间 URI 的属性,则用新属性替换它。

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

参数

newAttr Attr

新属性。

返回

Attr

返回属性

ToggleAttribute(string)

如果未给出强制参数,则“切换” qualifiedName,如果存在则移除它,如果不存在则添加它。如果强制为 true,则添加 qualifiedName。 如果强制为 false,则移除 qualifiedName。

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

参数

qualifiedName string

属性限定名。

返回

bool

如果 qualifiedName 现在存在,则返回 true;否则返回 false。

ToggleAttribute(string, bool)

如果未给出强制参数,则“切换” qualifiedName,如果存在则移除它,如果不存在则添加它。如果强制为 true,则添加 qualifiedName。 如果强制为 false,则移除 qualifiedName。

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

参数

qualifiedName string

属性限定名。

force bool

切换属性的强制选项。

返回

bool

如果 qualifiedName 现在存在,则返回 true;否则返回 false。

 中文