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)
زمانی که ویژگی با نام محلی و URI فضای نام مشخص شده بر روی این عنصر مشخص شده باشد یا دارای یک مقدار پیش‌فرض باشد، true را برمی‌گرداند، در غیر این صورت 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 فضای نام در عنصر وجود داشته باشد، پیشوند آن به بخش پیشوند qualifiedName تغییر می‌کند و مقدار آن به مقدار پارامتر 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 داده نشده باشد، “toggle” qualifiedName را انجام می‌دهد، آن را حذف می‌کند اگر موجود باشد و اضافه می‌کند اگر موجود نباشد. اگر force true باشد، qualifiedName را اضافه می‌کند. اگر force false باشد، qualifiedName را حذف می‌کند.
[DOMName("toggleAttribute")]
public bool ToggleAttribute(string qualifiedName)پارامترها
qualifiedName string
ویژگی QualifiedName.
بازگشت
اگر qualifiedName اکنون موجود باشد، true را برمی‌گرداند؛ در غیر این صورت false.
ToggleAttribute(string, bool)
اگر force داده نشده باشد، “toggle” qualifiedName را انجام می‌دهد، آن را حذف می‌کند اگر موجود باشد و اضافه می‌کند اگر موجود نباشد. اگر force true باشد، qualifiedName را اضافه می‌کند. اگر force false باشد، qualifiedName را حذف می‌کند.
[DOMName("toggleAttribute")]
public bool ToggleAttribute(string qualifiedName, bool force)پارامترها
qualifiedName string
ویژگی QualifiedName.
force bool
گزینه force برای toggle attribute.
بازگشت
اگر qualifiedName اکنون موجود باشد، true را برمی‌گرداند؛ در غیر این صورت false.
