Freigeben über


HtmlElement Klasse

Definition

Stellt ein HTML-Element innerhalb einer Webseite dar.

public ref class HtmlElement sealed
public sealed class HtmlElement
type HtmlElement = class
Public NotInheritable Class HtmlElement
Vererbung
HtmlElement

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie Sie ein beliebiges HTML-Dokument untersuchen und eine Zeichenfolge ableiten, die die HTML-Elemente beschreibt, wobei Einzüge und Ebenennummern verwendet werden, um anzugeben, wie tief geschachtelt die Elemente im Dokument sind. In diesem Codebeispiel muss ihre Anwendung ein WebBrowser Steuerelement mit dem Namen WebBrowser1hosten.

private void PrintDomBegin()
{
    if (webBrowser1.Document != null)
    {
        HtmlElementCollection elemColl = null;
        HtmlDocument doc = webBrowser1.Document;
        if (doc != null)
        {
            elemColl = doc.GetElementsByTagName("HTML");
            String str = PrintDom(elemColl, new System.Text.StringBuilder(), 0);
            webBrowser1.DocumentText = str;
        }
    }
}

private string PrintDom(HtmlElementCollection elemColl, System.Text.StringBuilder returnStr, Int32 depth)
{
    System.Text.StringBuilder str = new System.Text.StringBuilder();

    foreach (HtmlElement elem in elemColl)
    {
        string elemName;

        elemName = elem.GetAttribute("ID");
        if (elemName == null || elemName.Length == 0)
        {
            elemName = elem.GetAttribute("name");
            if (elemName == null || elemName.Length == 0)
            {
                elemName = "<no name>";
            }
        }

        str.Append(' ', depth * 4);
        str.Append(elemName + ": " + elem.TagName + "(Level " + depth + ")");
        returnStr.AppendLine(str.ToString());

        if (elem.CanHaveChildren)
        {
            PrintDom(elem.Children, returnStr, depth + 1);
        }

        str.Remove(0, str.Length);
    }

    return (returnStr.ToString());
}
Private Sub PrintDomBegin()
    If (WebBrowser1.Document IsNot Nothing) Then
        Dim ElemColl As HtmlElementCollection

        Dim Doc As HtmlDocument = WebBrowser1.Document
        If (Not (Doc Is Nothing)) Then
            ElemColl = Doc.GetElementsByTagName("HTML")
            Dim Str As String = PrintDom(ElemColl, New System.Text.StringBuilder(), 0)

            WebBrowser1.DocumentText = Str
        End If
    End If
End Sub

Private Function PrintDom(ByVal ElemColl As HtmlElementCollection, ByRef ReturnStr As System.Text.StringBuilder, ByVal Depth As Integer) As String
    Dim Str As New System.Text.StringBuilder()

    For Each Elem As HtmlElement In ElemColl
        Dim ElemName As String

        ElemName = Elem.GetAttribute("ID")
        If (ElemName Is Nothing Or ElemName.Length = 0) Then
            ElemName = Elem.GetAttribute("name")
            If (ElemName Is Nothing Or ElemName.Length = 0) Then
                ElemName = "<no name>"
            End If
        End If

        Str.Append(CChar(" "), Depth * 4)
        Str.Append(ElemName & ": " & Elem.TagName & "(Level " & Depth & ")")
        ReturnStr.AppendLine(Str.ToString())

        If (Elem.CanHaveChildren) Then
            PrintDom(Elem.Children, ReturnStr, Depth + 1)
        End If

        Str.Remove(0, Str.Length)
    Next

    PrintDom = ReturnStr.ToString()
End Function

Hinweise

HtmlElement stellt alle möglichen Elementtypen in einem HTML-Dokument dar, z BODY. B. , TABLE, und FORM, unter anderem. Die Klasse macht die am häufigsten verwendeten Eigenschaften verfügbar, die Sie für alle Elemente erwarten können.

Die meisten Elemente können untergeordnete Elemente aufweisen: andere HTML-Elemente, die darunter platziert werden. Verwenden Sie die CanHaveChildren Eigenschaft, um zu testen, ob ein bestimmtes Element untergeordnete Elemente hat, und die Children Auflistung, um sie zu durchlaufen. Die Parent Eigenschaft gibt die HtmlElement Schachtelung des aktuellen Elements zurück.

Häufig benötigen Sie Zugriff auf Attribute, Eigenschaften und Methoden für das zugrunde liegende Element, das nicht direkt verfügbar HtmlElementgemacht wird, z. B. das SRC Attribut für ein IMG Element oder die Submit Methode für ein .FORM SetAttribute Mit den GetAttribute Methoden können Sie attribute oder Eigenschaften für ein bestimmtes Element abrufen und ändern, während InvokeMember sie Zugriff auf alle Methoden bietet, die im verwalteten Dokumentobjektmodell (DOCUMENT Object Model, DOM) nicht verfügbar gemacht werden. Wenn Ihre Anwendung über nicht verwaltete Codeberechtigungen verfügt, können Sie auch auf nicht exponierte Eigenschaften und Methoden mit dem DomElement Attribut zugreifen.

Verwenden Sie die TagName Eigenschaft, um zu testen, ob ein Element einen bestimmten Typ aufweist.

Jedes HTML-Dokument kann zur Laufzeit geändert werden. Sie können neue HtmlElement Objekte mit der CreateElement Methode von HtmlDocument, und sie einem anderen Element mithilfe der AppendChild Methoden oder InsertAdjacentElement Methoden hinzufügen. Sie können die Elemente auch als HTML-Tags erstellen und sie der Eigenschaft eines vorhandenen Elements InnerHtml zuweisen.

Eigenschaften

Name Beschreibung
All

Ruft eins HtmlElementCollection aller Elemente unterhalb des aktuellen Elements ab.

CanHaveChildren

Ruft einen Wert ab, der angibt, ob dieses Element untergeordnete Elemente enthalten kann.

Children

Ruft eins HtmlElementCollection aller untergeordneten Elemente des aktuellen Elements ab.

ClientRectangle

Ruft die Grenzen des Clientbereichs des Elements im HTML-Dokument ab.

Document

Ruft das HtmlDocument Element ab, zu dem dieses Element gehört.

DomElement

Ruft einen nicht verwalteten Schnittstellenzeiger für dieses Element ab.

Enabled

Ruft ab oder legt fest, ob der Benutzer Daten in dieses Element eingeben kann.

FirstChild

Ruft das nächste Element unter diesem Element in der Dokumentstruktur ab.

Id

Dient zum Abrufen oder Festlegen einer Beschriftung, mit der das Element identifiziert werden soll.

InnerHtml

Ruft das HTML-Markup unter diesem Element ab oder legt es fest.

InnerText

Ruft den dem Element zugewiesenen Text ab oder legt diesen fest.

Name

Dient zum Abrufen oder Festlegen des Namens des Elements.

NextSibling

Ruft das nächste Element auf derselben Ebene wie dieses Element in der Dokumentstruktur ab.

OffsetParent

Ruft das Element ab, aus dem OffsetRectangle berechnet wird.

OffsetRectangle

Ruft die Position eines Elements relativ zum übergeordneten Element ab.

OuterHtml

Dient zum Abrufen oder Festlegen des HTML-Codes des aktuellen Elements.

OuterText

Ruft den Text des aktuellen Elements ab oder legt den Text fest.

Parent

Ruft das übergeordnete Element des aktuellen Elements ab.

ScrollLeft

Dient zum Abrufen oder Festlegen des Abstands zwischen dem Rand des Elements und dem linken Rand des Inhalts.

ScrollRectangle

Ruft die Dimensionen des Bildlaufbereichs eines Elements ab.

ScrollTop

Dient zum Abrufen oder Festlegen des Abstands zwischen dem Rand des Elements und dem oberen Rand des Inhalts.

Style

Dient zum Abrufen oder Festlegen einer durch Semikolons getrennten Liste von Formatvorlagen für das aktuelle Element.

TabIndex

Dient zum Abrufen oder Festlegen der Position dieses Elements in der Aktivierreihenfolge.

TagName

Ruft den Namen des HTML-Tags ab.

Methoden

Name Beschreibung
AppendChild(HtmlElement)

Fügt der Unterstruktur eines anderen Elements ein Element hinzu.

AttachEventHandler(String, EventHandler)

Fügt einen Ereignishandler für ein benanntes Ereignis im HTML-Dokumentobjektmodell (DOM) hinzu.

DetachEventHandler(String, EventHandler)

Entfernt einen Ereignishandler aus einem benannten Ereignis im HTML-Dokumentobjektmodell (DOM).

Equals(Object)

Testet, ob das angegebene Objekt dem aktuellen Element entspricht.

Focus()

Platziert den Fokus der Benutzereingabe auf das aktuelle Element.

GetAttribute(String)

Ruft den Wert des benannten Attributs für das Element ab.

GetElementsByTagName(String)

Ruft eine Auflistung von Elementen ab, die im HTML-Code durch das angegebene HTML Tag dargestellt werden.

GetHashCode()

Dient als Hashfunktion für einen bestimmten Typ.

GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
InsertAdjacentElement(HtmlElementInsertionOrientation, HtmlElement)

Fügen Sie ein neues Element in das Document Object Model (DOM) ein.

InvokeMember(String, Object[])

Führt eine Funktion aus, die auf der aktuellen HTML-Seite durch eine Skriptsprache definiert ist.

InvokeMember(String)

Führt eine nicht exponierte Methode für das zugrunde liegende DOM-Element dieses Elements aus.

MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
RaiseEvent(String)

Ruft das benannte Ereignis alle registrierten Ereignishandler auf.

RemoveFocus()

Entfernt den Fokus aus dem aktuellen Element, wenn dieses Element den Fokus hat.

ScrollIntoView(Boolean)

Scrollt durch das Dokument, das dieses Element enthält, bis der obere oder untere Rand dieses Elements am Fenster des Dokuments ausgerichtet ist.

SetAttribute(String, String)

Legt den Wert des benannten Attributs für das Element fest.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Operatoren

Name Beschreibung
Equality(HtmlElement, HtmlElement)

Vergleicht zwei Elemente für Gleichheit.

Inequality(HtmlElement, HtmlElement)

Überprüft zwei HtmlElement-Objekte auf Ungleichheit.

Ereignisse

Name Beschreibung
Click

Tritt auf, wenn der Benutzer mit der linken Maustaste auf das Element klickt.

DoubleClick

Tritt auf, wenn der Benutzer zweimal auf die linke Maustaste auf ein Element klickt, in schneller Folge.

Drag

Tritt auf, wenn der Benutzer Text an verschiedene Positionen zieht.

DragEnd

Tritt auf, wenn ein Benutzer einen Ziehvorgang beendet hat.

DragLeave

Tritt auf, wenn der Benutzer ein Element nicht mehr über dieses Element zieht.

DragOver

Tritt auf, wenn der Benutzer Text über das Element zieht.

Focusing

Tritt auf, wenn das Element zuerst den Benutzereingabefokus erhält.

GotFocus

Tritt auf, wenn das Element den Benutzereingabefokus erhalten hat.

KeyDown

Tritt auf, wenn der Benutzer eine Taste auf der Tastatur drückt.

KeyPress

Tritt auf, wenn der Benutzer eine Taste auf der Tastatur drückt und loslässt.

KeyUp

Tritt auf, wenn der Benutzer eine Taste auf der Tastatur loslässt.

LosingFocus

Tritt auf, wenn das Element den Benutzereingabefokus verliert.

LostFocus

Tritt auf, wenn das Element den Benutzereingabefokus verloren hat.

MouseDown

Tritt auf, wenn der Benutzer eine Maustaste drückt.

MouseEnter

Tritt auf, wenn der Benutzer den Mauszeiger zum ersten Mal über das aktuelle Element bewegt.

MouseLeave

Tritt auf, wenn der Benutzer den Mauszeiger aus dem aktuellen Element verschiebt.

MouseMove

Tritt auf, wenn der Benutzer den Mauszeiger über das Element bewegt.

MouseOver

Tritt auf, wenn der Mauszeiger die Grenzen des Elements eingibt.

MouseUp

Tritt auf, wenn der Benutzer eine Maustaste loslässt.

Gilt für:

Weitere Informationen