Class Element
Namespace: Aspose.Html.Dom
Assembly: Aspose.HTML.dll (25.1.0)
Interfejs Element reprezentuje element w dokumencie HTML lub XML.
[ComVisible(true)]
[DOMObject]
[DOMName("Element")]
public class Element : Node, INotifyPropertyChanged, IEventTarget, IDisposable, IXPathNSResolver, IParentNode, IElementTraversal, IChildNodeDziedziczenie
object ← DOMObject ← EventTarget ← Node ← Element
Pochodne
Implementuje
INotifyPropertyChanged, IEventTarget, IDisposable, IXPathNSResolver, IParentNode, IElementTraversal, IChildNode
Dziedziczone członkowie
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()
Konstruktory
Element(QualifiedName, Document)
Inicjalizuje nową instancję klasy Aspose.Html.Dom.Element. Nie wywołuj tego konstruktora bezpośrednio, użyj Aspose.Html.Dom.Document.CreateElement(System.String) lub Aspose.Html.Dom.Document.CreateElementNS(System.String,System.String).
public Element(QualifiedName qualifiedName, Document document)Parametry
qualifiedName QualifiedName
Kwalifikowana nazwa.
document Document
Powiązany dokument.
Właściwości
Attributes
A NamedNodeMap zawierający atrybuty tego węzła (jeśli jest to Element) lub null w przeciwnym razie.
[DOMName("attributes")]
public NamedNodeMap Attributes { get; }Wartość właściwości
ChildElementCount
Zwraca aktualną liczbę węzłów elementów, które są dziećmi tego elementu. 0, jeśli ten element nie ma węzłów dziecięcych typu nodeType 1.
public int ChildElementCount { get; }Wartość właściwości
Children
Zwraca elementy dzieci bieżącego elementu.
public HTMLCollection Children { get; }Wartość właściwości
ClassList
Zwraca aktualną DOMTokenList, która zawiera tokeny uzyskane z analizy atrybutu “class”.
[DOMName("classList")]
public DOMTokenList ClassList { get; }Wartość właściwości
ClassName
Atrybut klasy elementu. Ten atrybut został przemianowany z powodu konfliktów z słowem kluczowym “class” udostępnionym przez wiele języków. Zobacz definicję atrybutu klasy w HTML 4.01.
[DOMName("className")]
public string ClassName { get; set; }Wartość właściwości
FirstElementChild
Zwraca pierwszy węzeł elementu dziecka tego elementu. null, jeśli ten element nie ma elementów dzieci.
public Element FirstElementChild { get; }Wartość właściwości
Id
Identyfikator elementu. Zobacz definicję atrybutu id w HTML 4.01.
[DOMName("id")]
public string Id { get; set; }Wartość właściwości
InnerHTML
Zwraca fragment HTML lub XML, który reprezentuje zawartość elementu. Może być ustawiony, aby zastąpić zawartość elementu węzłami analizowanymi z podanego ciągu.
[DOMName("innerHTML")]
public string InnerHTML { get; set; }Wartość właściwości
LastElementChild
Zwraca ostatni węzeł elementu dziecka tego elementu. null, jeśli ten element nie ma elementów dzieci.
public Element LastElementChild { get; }Wartość właściwości
LocalName
Zwraca lokalną część kwalifikowanej nazwy tego węzła. Dla węzłów dowolnego typu innego niż ELEMENT_NODE i ATTRIBUTE_NODE oraz węzłów utworzonych za pomocą metody DOM Level 1, takiej jak Document.createElement(), jest to zawsze null.
public override string LocalName { get; }Wartość właściwości
NamespaceURI
URI przestrzeni nazw tego węzła lub null, jeśli nie jest określony.
[DOMNullable]
[DOMName("namespaceURI")]
public override string NamespaceURI { get; }Wartość właściwości
NextElementSibling
Zwraca następny węzeł elementu rodzeństwa tego elementu. null, jeśli ten element nie ma węzłów rodzeństwa elementów, które występują po tym w drzewie dokumentu.
public Element NextElementSibling { get; }Wartość właściwości
NodeName
Nazwa tego węzła, w zależności od jego typu.
public override string NodeName { get; }Wartość właściwości
NodeType
Kod reprezentujący typ bazowego obiektu.
public override ushort NodeType { get; }Wartość właściwości
OuterHTML
Zwraca fragment HTML lub XML, który reprezentuje element i jego zawartość. Może być ustawiony, aby zastąpić element węzłami analizowanymi z podanego ciągu.
[DOMName("outerHTML")]
public string OuterHTML { get; set; }Wartość właściwości
Prefix
Prefiks przestrzeni nazw tego węzła lub null, jeśli nie jest określony. Gdy jest zdefiniowany jako null, jego ustawienie nie ma żadnego efektu.
[DOMNullable]
[DOMName("prefix")]
public override string Prefix { get; }Wartość właściwości
PreviousElementSibling
Zwraca poprzedni węzeł elementu rodzeństwa tego elementu. null, jeśli ten element nie ma węzłów rodzeństwa elementów, które występują przed tym w drzewie dokumentu.
public Element PreviousElementSibling { get; }Wartość właściwości
ShadowRoot
Zwraca shadowRoot przechowywany w tym elemencie lub null, jeśli jest zamknięty.
[DOMName("shadowRoot")]
public ShadowRoot ShadowRoot { get; }Wartość właściwości
TagName
Nazwa elementu.
[DOMName("tagName")]
public string TagName { get; }Wartość właściwości
TextContent
Ten atrybut zwraca zawartość tekstową tego węzła i jego potomków. Gdy jest zdefiniowany jako null, jego ustawienie nie ma żadnego efektu. Przy ustawieniu wszelkie możliwe dzieci, jakie może mieć ten węzeł, są usuwane, a jeśli nowy ciąg nie jest pusty ani null, zastępowany przez pojedynczy węzeł tekstowy zawierający ciąg, na który ten atrybut jest ustawiony.
public override string TextContent { get; set; }Wartość właściwości
Metody
AttachShadow(ShadowRootMode)
Tworzy shadow root i dołącza go do bieżącego elementu.
[DOMName("attachShadow")]
public ShadowRoot AttachShadow(ShadowRootMode mode)Parametry
mode ShadowRootMode
Tryb, w którym zostanie utworzony shadow root.
Zwraca
Utworzony Aspose.Html.Dom.ShadowRoot.
Wyjątki
NotSupportedError: Element nie obsługuje drzewa cieni.
InvalidStateError: Element już ma drzewo cieni.
Dispose(bool)
Zwalnia zasoby niezarządzane i - opcjonalnie - zarządzane.
protected override void Dispose(bool disposing)Parametry
disposing bool
true, aby zwolnić zarówno zasoby zarządzane, jak i niezarządzane; false, aby zwolnić tylko zasoby niezarządzane.
GetAttribute(string)
Pobiera wartość atrybutu według nazwy.
[DOMNullable]
[DOMName("getAttribute")]
public string GetAttribute(string qualifiedName)Parametry
qualifiedName string
Nazwa atrybutu do pobrania.
Zwraca
Zwraca wartość atrybutu.
GetAttributeNS(string, string)
Pobiera wartość atrybutu według lokalnej nazwy i URI przestrzeni nazw.
[DOMNullable]
[DOMName("getAttributeNS")]
public string GetAttributeNS(string namespaceURI, string localName)Parametry
namespaceURI string
URI przestrzeni nazw.
localName string
Nazwa lokalna.
Zwraca
Zwraca atrybut.
GetAttributeNames()
Zwraca nazwy atrybutów elementu jako tablicę ciągów. Jeśli element nie ma atrybutów, zwraca pustą tablicę.
[DOMName("getAttributeNames")]
public string[] GetAttributeNames()Zwraca
string[]
Tablica ciągów reprezentująca nazwy atrybutów.
GetAttributeNode(string)
Pobiera węzeł atrybutu według nazwy.
[DOMName("getAttributeNode")]
public Attr GetAttributeNode(string qualifiedName)Parametry
qualifiedName string
Nazwa atrybutu.
Zwraca
Zwraca wartość atrybutu.
GetAttributeNodeNS(string, string)
Pobiera węzeł Attr według lokalnej nazwy i URI przestrzeni nazw.
[DOMName("getAttributeNodeNS")]
public Attr GetAttributeNodeNS(string namespaceURI, string localName)Parametry
namespaceURI string
URI przestrzeni nazw.
localName string
Nazwa lokalna.
Zwraca
Zwraca atrybut.
GetElementsByClassName(string)
Zwraca żywy obiekt NodeList zawierający wszystkie elementy w dokumencie, które mają wszystkie klasy określone w argumencie.
http://www.w3.org/TR/dom/
[DOMName("getElementsByClassName")]
public HTMLCollection GetElementsByClassName(string classNames)Parametry
classNames string
Ciąg, który zawiera nieuporządkowany zestaw unikalnych tokenów oddzielonych spacjami reprezentujących klasy (nazwy klas).
Zwraca
Element Aspose.Html.Dom.Element.
GetElementsByTagName(string)
Zwraca NodeList wszystkich potomnych elementów o danej nazwie tagu, w kolejności dokumentu.
[DOMName("getElementsByTagName")]
public HTMLCollection GetElementsByTagName(string name)Parametry
name string
Nazwa tagu.
Zwraca
Zwraca atrybut.
GetElementsByTagNameNS(string, string)
Zwraca NodeList wszystkich potomnych elementów o danej lokalnej nazwie i URI przestrzeni nazw w kolejności dokumentu.
[DOMName("getElementsByTagNameNS")]
public HTMLCollection GetElementsByTagNameNS(string namespaceURI, string localName)Parametry
namespaceURI string
URI przestrzeni nazw.
localName string
Nazwa lokalna.
Zwraca
Zwraca elementy.
HasAttribute(string)
Zwraca true, gdy atrybut o danej nazwie jest określony na tym elemencie lub ma wartość domyślną, w przeciwnym razie false.
[DOMName("hasAttribute")]
public bool HasAttribute(string qualifiedName)Parametry
qualifiedName string
Nazwa atrybutu.
Zwraca
true, jeśli określona nazwa ma atrybut; w przeciwnym razie false.
HasAttributeNS(string, string)
Zwraca true, gdy atrybut o danej lokalnej nazwie i URI przestrzeni nazw jest określony na tym elemencie lub ma wartość domyślną, w przeciwnym razie false.
[DOMName("hasAttributeNS")]
public bool HasAttributeNS(string namespaceURI, string localName)Parametry
namespaceURI string
URI przestrzeni nazw.
localName string
Nazwa lokalna.
Zwraca
true, jeśli [ma atrybut NS] [określony URI przestrzeni nazw]; w przeciwnym razie false.
HasAttributes()
Zwraca, czy ten węzeł (jeśli jest elementem) ma jakiekolwiek atrybuty.
[DOMName("hasAttributes")]
public bool HasAttributes()Zwraca
boolean true, jeśli ten węzeł ma jakiekolwiek atrybuty, false w przeciwnym razie.
QuerySelector(string)
Zwraca pierwszy element w dokumencie, który pasuje do selektora.
public Element QuerySelector(string selector)Parametry
selector string
Selektor.
Zwraca
Dopasowany element.
QuerySelectorAll(string)
Zwraca NodeList wszystkich elementów w dokumencie, które pasują do selektora.
public NodeList QuerySelectorAll(string selector)Parametry
selector string
Selektor.
Zwraca
Aspose.Html.Collections.HTMLCollection.
Remove()
Usuwa tę instancję.
public void Remove()RemoveAttribute(string)
Usuwa atrybut według nazwy.
[DOMName("removeAttribute")]
public void RemoveAttribute(string qualifiedName)Parametry
qualifiedName string
Nazwa atrybutu.
RemoveAttributeNS(string, string)
Usuwa atrybut według lokalnej nazwy i URI przestrzeni nazw.
[DOMName("removeAttributeNS")]
public void RemoveAttributeNS(string namespaceURI, string localName)Parametry
namespaceURI string
URI przestrzeni nazw.
localName string
Nazwa lokalna.
RemoveAttributeNode(Attr)
Usuwa określony węzeł atrybutu.
[DOMName("removeAttributeNode")]
public Attr RemoveAttributeNode(Attr oldAttr)Parametry
oldAttr Attr
Stary atrybut.
Zwraca
Zwraca atrybut.
SetAttribute(string, string)
Dodaje nowy atrybut. Jeśli atrybut o tej nazwie już istnieje w elemencie, jego wartość jest zmieniana na wartość parametru.
[DOMName("setAttribute")]
public void SetAttribute(string qualifiedName, string value)Parametry
qualifiedName string
Nazwa atrybutu.
value string
Wartość.
SetAttributeNS(string, string, string)
Dodaje nowy atrybut. Jeśli atrybut o tej samej lokalnej nazwie i URI przestrzeni nazw już istnieje w elemencie, jego prefiks jest zmieniany na część prefiksu kwalifikowanej nazwy, a jego wartość jest zmieniana na wartość parametru.
[DOMName("setAttributeNS")]
public void SetAttributeNS(string namespaceURI, string qualifiedName, string value)Parametry
namespaceURI string
URI przestrzeni nazw.
qualifiedName string
Nazwa kwalifikowana.
value string
Wartość.
SetAttributeNode(Attr)
Dodaje nowy węzeł atrybutu. Jeśli atrybut o tej nazwie (nodeName) już istnieje w elemencie, jest zastępowany nowym.
[DOMName("setAttributeNode")]
public Attr SetAttributeNode(Attr newAttr)Parametry
newAttr Attr
Nowy atrybut.
Zwraca
Zwraca atrybut.
SetAttributeNodeNS(Attr)
Dodaje nowy atrybut. Jeśli atrybut o tej lokalnej nazwie i tej przestrzeni nazw już istnieje w elemencie, jest zastępowany nowym.
[DOMName("setAttributeNodeNS")]
public Attr SetAttributeNodeNS(Attr newAttr)Parametry
newAttr Attr
Nowy atrybut.
Zwraca
Zwraca atrybut.
ToggleAttribute(string)
Jeśli nie podano opcji force, “przełącza” qualifiedName, usuwając go, jeśli jest obecny, i dodając, jeśli nie jest obecny. Jeśli force jest true, dodaje qualifiedName. Jeśli force jest false, usuwa qualifiedName.
[DOMName("toggleAttribute")]
public bool ToggleAttribute(string qualifiedName)Parametry
qualifiedName string
Kwalifikowana nazwa atrybutu.
Zwraca
Zwraca true, jeśli qualifiedName jest teraz obecny; w przeciwnym razie false.
ToggleAttribute(string, bool)
Jeśli nie podano opcji force, “przełącza” qualifiedName, usuwając go, jeśli jest obecny, i dodając, jeśli nie jest obecny. Jeśli force jest true, dodaje qualifiedName. Jeśli force jest false, usuwa qualifiedName.
[DOMName("toggleAttribute")]
public bool ToggleAttribute(string qualifiedName, bool force)Parametry
qualifiedName string
Kwalifikowana nazwa atrybutu.
force bool
Opcja wymuszenia do przełączenia atrybutu.
Zwraca
Zwraca true, jeśli qualifiedName jest teraz obecny; w przeciwnym razie false.
