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
返回当前作为此元素子节点的元素节点数量。如果此元素没有子节点且节点类型为 1,则返回 0。
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
元素的标识符。请参见 HTML 4.01 中的 id 属性定义。
[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: 元素不支持 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
要检索的属性名称。
返回
返回属性值
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)
通过本地名称和命名空间 URI 检索 Attr 节点。
[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)
返回具有给定本地名称和命名空间 URI 的所有后代元素的 NodeList,按文档顺序排列。
[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)
当此元素上指定具有给定本地名称和命名空间 URI 的属性或具有默认值时,返回 true,否则返回 false。
[DOMName("hasAttributeNS")]
public bool HasAttributeNS(string namespaceURI, string localName)
参数
namespaceURI
string
命名空间 URI。
localName
string
本地名称。
返回
true
如果指定命名空间 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)
添加新属性。如果元素中已经存在同名属性,则其值更改为值参数的值。
[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
新属性。
返回
返回属性
SetAttributeNodeNS(Attr)
添加新属性。如果元素中已经存在同一本地名称和命名空间 URI 的属性,则用新属性替换它。
[DOMName("setAttributeNodeNS")]
public Attr SetAttributeNodeNS(Attr newAttr)
参数
newAttr
Attr
新属性。
返回
返回属性
ToggleAttribute(string)
如果未给出强制参数,则“切换” qualifiedName,如果存在则移除它,如果不存在则添加它。如果强制为 true,则添加 qualifiedName。 如果强制为 false,则移除 qualifiedName。
[DOMName("toggleAttribute")]
public bool ToggleAttribute(string qualifiedName)
参数
qualifiedName
string
属性限定名。
返回
如果 qualifiedName 现在存在,则返回 true;否则返回 false。
ToggleAttribute(string, bool)
如果未给出强制参数,则“切换” qualifiedName,如果存在则移除它,如果不存在则添加它。如果强制为 true,则添加 qualifiedName。 如果强制为 false,则移除 qualifiedName。
[DOMName("toggleAttribute")]
public bool ToggleAttribute(string qualifiedName, bool force)
参数
qualifiedName
string
属性限定名。
force
bool
切换属性的强制选项。
返回
如果 qualifiedName 现在存在,则返回 true;否则返回 false。