Class Element
Namespace: Aspose.Html.Dom
Assembly: Aspose.HTML.dll (25.1.0)
Interface Element reprezentuje prvek v dokumentu HTML nebo XML.
[ComVisible(true)]
[DOMObject]
[DOMName("Element")]
public class Element : Node, INotifyPropertyChanged, IEventTarget, IDisposable, IXPathNSResolver, IParentNode, IElementTraversal, IChildNode
Dědění
object ← DOMObject ← EventTarget ← Node ← Element
Odvozené
Implementace
INotifyPropertyChanged, IEventTarget, IDisposable, IXPathNSResolver, IParentNode, IElementTraversal, IChildNode
Děděné členy
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)
Inicializuje novou instanci třídy Aspose.Html.Dom.Element. Nepoužívejte tento konstruktor přímo, použijte Aspose.Html.Dom.Document.CreateElement(System.String) nebo Aspose.Html.Dom.Document.CreateElementNS(System.String,System.String).
public Element(QualifiedName qualifiedName, Document document)
Parametry
qualifiedName
QualifiedName
Kvalifikované jméno.
document
Document
Příslušný dokument.
Vlastnosti
Attributes
NamedNodeMap obsahující atributy tohoto uzlu (pokud je to prvek), nebo null, pokud ne.
[DOMName("attributes")]
public NamedNodeMap Attributes { get; }
Hodnota vlastnosti
ChildElementCount
Vrací aktuální počet elementů, které jsou dětmi tohoto prvku. 0, pokud tento prvek nemá žádné dětské uzly typu nodeType 1.
public int ChildElementCount { get; }
Hodnota vlastnosti
Children
Vrací dětské prvky aktuálního prvku.
public HTMLCollection Children { get; }
Hodnota vlastnosti
ClassList
Vrací živý DOMTokenList, který obsahuje tokeny získané z analýzy atributu “class”.
[DOMName("classList")]
public DOMTokenList ClassList { get; }
Hodnota vlastnosti
ClassName
Atribut třídy prvku. Tento atribut byl přejmenován kvůli konfliktům s klíčovým slovem “class”, které používá mnoho jazyků. Viz definice atributu třídy v HTML 4.01.
[DOMName("className")]
public string ClassName { get; set; }
Hodnota vlastnosti
FirstElementChild
Vrací první dětský uzel prvku tohoto prvku. null, pokud tento prvek nemá žádné dětské prvky.
public Element FirstElementChild { get; }
Hodnota vlastnosti
Id
Identifikátor prvku. Viz definice atributu id v HTML 4.01.
[DOMName("id")]
public string Id { get; set; }
Hodnota vlastnosti
InnerHTML
Vrací fragment HTML nebo XML, který reprezentuje obsah prvku. Lze nastavit, aby nahradil obsah prvku uzly analyzovanými ze zadaného řetězce.
[DOMName("innerHTML")]
public string InnerHTML { get; set; }
Hodnota vlastnosti
LastElementChild
Vrací poslední dětský uzel prvku tohoto prvku. null, pokud tento prvek nemá žádné dětské prvky.
public Element LastElementChild { get; }
Hodnota vlastnosti
LocalName
Vrací místní část kvalifikovaného jména tohoto uzlu. U uzlů jakéhokoli typu kromě ELEMENT_NODE a ATTRIBUTE_NODE a uzlů vytvořených metodou DOM Level 1, jako je Document.createElement(), je to vždy null.
public override string LocalName { get; }
Hodnota vlastnosti
NamespaceURI
URI prostoru názvů tohoto uzlu, nebo null, pokud není specifikován.
[DOMNullable]
[DOMName("namespaceURI")]
public override string NamespaceURI { get; }
Hodnota vlastnosti
NextElementSibling
Vrací následující sourozenecký uzel prvku tohoto prvku. null, pokud tento prvek nemá žádné sourozenecké uzly prvku, které přicházejí po tomto v dokumentovém stromě.
public Element NextElementSibling { get; }
Hodnota vlastnosti
NodeName
Název tohoto uzlu, v závislosti na jeho typu.
public override string NodeName { get; }
Hodnota vlastnosti
NodeType
Kód reprezentující typ podkladového objektu.
public override ushort NodeType { get; }
Hodnota vlastnosti
OuterHTML
Vrací fragment HTML nebo XML, který reprezentuje prvek a jeho obsah. Lze nastavit, aby nahradil prvek uzly analyzovanými ze zadaného řetězce.
[DOMName("outerHTML")]
public string OuterHTML { get; set; }
Hodnota vlastnosti
Prefix
Předpona prostoru názvů tohoto uzlu, nebo null, pokud není specifikována. Když je definována jako null, její nastavení nemá žádný účinek.
[DOMNullable]
[DOMName("prefix")]
public override string Prefix { get; }
Hodnota vlastnosti
PreviousElementSibling
Vrací předchozí sourozenecký uzel prvku tohoto prvku. null, pokud tento prvek nemá žádné sourozenecké uzly prvku, které přicházejí před tímto v dokumentovém stromě.
public Element PreviousElementSibling { get; }
Hodnota vlastnosti
ShadowRoot
Vrací shadowRoot uložený na tomto prvku nebo null, pokud je uzavřený.
[DOMName("shadowRoot")]
public ShadowRoot ShadowRoot { get; }
Hodnota vlastnosti
TagName
Název prvku.
[DOMName("tagName")]
public string TagName { get; }
Hodnota vlastnosti
TextContent
Tento atribut vrací textový obsah tohoto uzlu a jeho potomků. Když je definován jako null, jeho nastavení nemá žádný účinek. Při nastavení jsou odstraněny všechny možné děti, které může tento uzel mít, a pokud je nový řetězec neprázdný nebo null, je nahrazen jediným textovým uzlem obsahujícím řetězec, na který je tento atribut nastaven.
public override string TextContent { get; set; }
Hodnota vlastnosti
Metody
AttachShadow(ShadowRootMode)
Vytváří shadow root a připojuje ho k aktuálnímu prvku.
[DOMName("attachShadow")]
public ShadowRoot AttachShadow(ShadowRootMode mode)
Parametry
mode
ShadowRootMode
Režim, ve kterém bude shadow root vytvořen.
Vrací
Vytvořený Aspose.Html.Dom.ShadowRoot.
Výjimky
NotSupportedError: Prvek nepodporuje stínový strom.
InvalidStateError: Prvek již má stínový strom.
Dispose(bool)
Uvolňuje neřízené a - volitelně - řízené prostředky.
protected override void Dispose(bool disposing)
Parametry
disposing
bool
true
pro uvolnění řízených i neřízených prostředků; false
pro uvolnění pouze neřízených prostředků.
GetAttribute(string)
Získává hodnotu atributu podle názvu.
[DOMNullable]
[DOMName("getAttribute")]
public string GetAttribute(string qualifiedName)
Parametry
qualifiedName
string
Název atributu, který se má získat.
Vrací
Vrací hodnotu atributu.
GetAttributeNS(string, string)
Získává hodnotu atributu podle místního názvu a URI prostoru názvů.
[DOMNullable]
[DOMName("getAttributeNS")]
public string GetAttributeNS(string namespaceURI, string localName)
Parametry
namespaceURI
string
URI prostoru názvů.
localName
string
Název místního.
Vrací
Vrací atribut.
GetAttributeNames()
Vrací názvy atributů prvku jako pole řetězců. Pokud prvek nemá žádné atributy, vrací prázdné pole.
[DOMName("getAttributeNames")]
public string[] GetAttributeNames()
Vrací
string[]
Pole řetězců představuje názvy atributů.
GetAttributeNode(string)
Získává uzel atributu podle názvu.
[DOMName("getAttributeNode")]
public Attr GetAttributeNode(string qualifiedName)
Parametry
qualifiedName
string
Název atributu.
Vrací
Vrací hodnotu atributu.
GetAttributeNodeNS(string, string)
Získává uzel Attr podle místního názvu a URI prostoru názvů.
[DOMName("getAttributeNodeNS")]
public Attr GetAttributeNodeNS(string namespaceURI, string localName)
Parametry
namespaceURI
string
URI prostoru názvů.
localName
string
Název místního.
Vrací
Vrací atribut.
GetElementsByClassName(string)
Vrací živý objekt NodeList obsahující všechny prvky v dokumentu, které mají všechny třídy uvedené v argumentu. http://www.w3.org/TR/dom/
[DOMName("getElementsByClassName")]
public HTMLCollection GetElementsByClassName(string classNames)
Parametry
classNames
string
Řetězec, který obsahuje neuspořádanou sadu unikátních tokenů oddělených mezerami, které představují třídy (názvy tříd).
Vrací
Prvek Aspose.Html.Dom.Element.
GetElementsByTagName(string)
Vrací NodeList všech potomků prvků s daným názvem tagu, v pořadí dokumentu.
[DOMName("getElementsByTagName")]
public HTMLCollection GetElementsByTagName(string name)
Parametry
name
string
Název tagu.
Vrací
Vrací atribut.
GetElementsByTagNameNS(string, string)
Vrací NodeList všech potomků prvků s daným místním názvem a URI prostoru názvů v pořadí dokumentu.
[DOMName("getElementsByTagNameNS")]
public HTMLCollection GetElementsByTagNameNS(string namespaceURI, string localName)
Parametry
namespaceURI
string
URI prostoru názvů.
localName
string
Název místního.
Vrací
Vrací prvky.
HasAttribute(string)
Vrací true, pokud je na tomto prvku specifikován atribut se zadaným názvem nebo má výchozí hodnotu, jinak false.
[DOMName("hasAttribute")]
public bool HasAttribute(string qualifiedName)
Parametry
qualifiedName
string
Název atributu.
Vrací
true
, pokud má specifikovaný název atribut; jinak false
.
HasAttributeNS(string, string)
Vrací true, pokud je na tomto prvku specifikován atribut s daným místním názvem a URI prostoru názvů nebo má výchozí hodnotu, jinak false.
[DOMName("hasAttributeNS")]
public bool HasAttributeNS(string namespaceURI, string localName)
Parametry
namespaceURI
string
URI prostoru názvů.
localName
string
Název místního.
Vrací
true
, pokud [má atribut NS] [specifikovaný URI prostoru názvů]; jinak false
.
HasAttributes()
Vrací, zda tento uzel (pokud je to prvek) má nějaké atributy.
[DOMName("hasAttributes")]
public bool HasAttributes()
Vrací
boolean true
, pokud tento uzel má nějaké atributy, jinak false
.
QuerySelector(string)
Vrací první prvek v dokumentu, který odpovídá selektoru.
public Element QuerySelector(string selector)
Parametry
selector
string
Selektor.
Vrací
Odpovídající prvek.
QuerySelectorAll(string)
Vrací NodeList všech prvků v dokumentu, které odpovídají selektoru.
public NodeList QuerySelectorAll(string selector)
Parametry
selector
string
Selektor.
Vrací
Aspose.Html.Collections.HTMLCollection.
Remove()
Odstraňuje tuto instanci.
public void Remove()
RemoveAttribute(string)
Odstraňuje atribut podle názvu.
[DOMName("removeAttribute")]
public void RemoveAttribute(string qualifiedName)
Parametry
qualifiedName
string
Název atributu.
RemoveAttributeNS(string, string)
Odstraňuje atribut podle místního názvu a URI prostoru názvů.
[DOMName("removeAttributeNS")]
public void RemoveAttributeNS(string namespaceURI, string localName)
Parametry
namespaceURI
string
URI prostoru názvů.
localName
string
Název místního.
RemoveAttributeNode(Attr)
Odstraňuje specifikovaný uzel atributu.
[DOMName("removeAttributeNode")]
public Attr RemoveAttributeNode(Attr oldAttr)
Parametry
oldAttr
Attr
Starý atribut.
Vrací
Vrací atribut.
SetAttribute(string, string)
Přidává nový atribut. Pokud je atribut se stejným názvem již přítomen v prvku, jeho hodnota se změní na hodnotu parametru value.
[DOMName("setAttribute")]
public void SetAttribute(string qualifiedName, string value)
Parametry
qualifiedName
string
Název atributu.
value
string
Hodnota.
SetAttributeNS(string, string, string)
Přidává nový atribut. Pokud je atribut se stejným místním názvem a URI prostoru názvů již přítomen v prvku, jeho předpona se změní na část prefixu qualifiedName a jeho hodnota se změní na hodnotu parametru value.
[DOMName("setAttributeNS")]
public void SetAttributeNS(string namespaceURI, string qualifiedName, string value)
Parametry
namespaceURI
string
URI prostoru názvů.
qualifiedName
string
Název kvalifikovaného.
value
string
Hodnota.
SetAttributeNode(Attr)
Přidává nový uzel atributu. Pokud je atribut se stejným názvem (nodeName) již přítomen v prvku, je nahrazen novým.
[DOMName("setAttributeNode")]
public Attr SetAttributeNode(Attr newAttr)
Parametry
newAttr
Attr
Nový atribut.
Vrací
Vrací atribut.
SetAttributeNodeNS(Attr)
Přidává nový atribut. Pokud je atribut se stejným místním názvem a URI prostoru názvů již přítomen v prvku, je nahrazen novým.
[DOMName("setAttributeNodeNS")]
public Attr SetAttributeNodeNS(Attr newAttr)
Parametry
newAttr
Attr
Nový atribut.
Vrací
Vrací atribut.
ToggleAttribute(string)
Pokud není zadán force, “přepíná” qualifiedName, odstraňuje ho, pokud je přítomen, a přidává ho, pokud není přítomen. Pokud je force true, přidá qualifiedName. Pokud je force false, odstraní qualifiedName.
[DOMName("toggleAttribute")]
public bool ToggleAttribute(string qualifiedName)
Parametry
qualifiedName
string
Kvalifikované jméno atributu.
Vrací
Vrátí true, pokud je qualifiedName nyní přítomno; jinak false.
ToggleAttribute(string, bool)
Pokud není zadán force, “přepíná” qualifiedName, odstraňuje ho, pokud je přítomen, a přidává ho, pokud není přítomen. Pokud je force true, přidá qualifiedName. Pokud je force false, odstraní qualifiedName.
[DOMName("toggleAttribute")]
public bool ToggleAttribute(string qualifiedName, bool force)
Parametry
qualifiedName
string
Kvalifikované jméno atributu.
force
bool
Možnost přepínání atributu.
Vrací
Vrátí true, pokud je qualifiedName nyní přítomno; jinak false.