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, die die HTML-Elemente beschreibt, mit Einzugs- und Levelzahlen, die verwendet werden, um anzugeben, wie tief geschachtelt die Elemente im Dokument sind. In diesem Codebeispiel ist erforderlich, dass Ihre Anwendung ein WebBrowser Steuerelement mit dem Namen " WebBrowser1.

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 Typen des Elements in einem HTML-Dokument dar, z. B. BODY, TABLE, und FORM, u. a. Die Klasse stellt die häufigsten Eigenschaften bereit, die Sie auf allen Elementen finden 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, die sie durchlaufen soll. Die Parent Eigenschaft gibt den HtmlElement Wert zurück, in dem das aktuelle Element geschachtelt ist.

Häufig benötigen Sie Zugriff auf Attribute, Eigenschaften und Methoden auf dem zugrunde liegenden Element, das nicht direkt verfügbar HtmlElementgemacht wird, z. B. das SRC Attribut auf einem IMG Element oder der Submit Methode auf einem FORM. SetAttribute Mit den GetAttribute Methoden können Sie alle Attribute oder Eigenschaften auf einem bestimmten Element abrufen und ändern, während InvokeMember sie Zugriff auf alle Methoden bietet, die im verwalteten Dokumentobjektmodell (DOM) nicht verfügbar gemacht werden. Wenn Ihre Anwendung nicht verwaltete Codeberechtigungen aufweist, können Sie auch auf nicht exposierte Eigenschaften und Methoden mit dem DomElement Attribut zugreifen.

Verwenden Sie die TagName Eigenschaft, um zu testen, ob ein Element eines bestimmten Typs ist.

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

Eigenschaften

All

Ruft eine HtmlElementCollection aller Elemente unterhalb des aktuellen Elements ab.

CanHaveChildren

Ruft einen Wert ab, der angibt, ob dieses Element über untergeordnete Elemente verfügen kann.

Children

Ruft eine HtmlElementCollection aller untergeordneten Elemente des aktuellen Elements ab.

ClientRectangle

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

Document

Ruft das HtmlDocument 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

Ruft eine Bezeichnung ab, durch die das Element identifiziert werden soll, oder legt diese fest.

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

Ruft den Namen des Elements ab oder legt diesen fest.

NextSibling

Ruft das nächste Element auf der gleichen 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 zu seinem übergeordneten Element ab.

OuterHtml

Ruft den HTML-Code des aktuellen Elements ab oder legt diesen fest.

OuterText

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

Parent

Ruft das übergeordnete Element des aktuellen Elements ab.

ScrollLeft

Ruft den Abstand zwischen dem Rand des Elements und dem linken Rand seines Inhalts ab oder legt diesen fest.

ScrollRectangle

Ruft die Dimensionen des bildlauffähigen Bereichs eines Elements ab.

ScrollTop

Ruft den Abstand zwischen dem Rand des Elements und dem oberen Rand seines Inhalts ab oder legt diesen fest.

Style

Ruft eine durch Semikola getrennte Liste der Formate für das aktuelle Element ab oder legt diese fest.

TabIndex

Ruft die Position dieses Elements in der Aktivierreihenfolge ab oder legt diese fest.

TagName

Ruft den Namen des HTML-Tags ab.

Methoden

AppendChild(HtmlElement)

Fügt der Teilstruktur eines Elements ein anderes Element hinzu.

AttachEventHandler(String, EventHandler)

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

DetachEventHandler(String, EventHandler)

Entfernt einen Ereignishandler von einem benannten Ereignis im HTML-DOM (Document Object Model).

Equals(Object)

Überprüft, ob das angegebene Objekt gleich dem aktuellen Element ist.

Focus()

Legt den Benutzereingabefokus auf das aktuelle Element fest.

GetAttribute(String)

Ruft den Wert des benannten Attributs im Element ab.

GetElementsByTagName(String)

Ruft eine Auflistung von Elementen ab, die in HTML durch das angegebene HTML-Tag dargestellt sind.

GetHashCode()

Dient als Hashfunktion für einen bestimmten Typ.

GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
InsertAdjacentElement(HtmlElementInsertionOrientation, HtmlElement)

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

InvokeMember(String)

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

InvokeMember(String, Object[])

Führt eine in der aktuellen HTML-Seite von einer Skriptsprache definierte Funktion aus.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
RaiseEvent(String)

Bewirkt, dass das benannte Ereignis alle registrierten Ereignishandler aufruft.

RemoveFocus()

Entfernt den Fokus vom aktuellen Element, wenn dieses Element den Fokus besitzt.

ScrollIntoView(Boolean)

Führt einen Bildlauf durch das Dokument mit diesem Element durch, bis der obere oder untere Rand dieses Elements am Dokumentenfenster 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

Equality(HtmlElement, HtmlElement)

Überprüft zwei Elemente auf Gleichheit.

Inequality(HtmlElement, HtmlElement)

Überprüft zwei HtmlElement-Objekte auf Ungleichheit.

Ereignisse

Click

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

DoubleClick

Tritt ein, wenn der Benutzer zweimal in rascher Folge mit der linken Maustaste auf ein Element klickt.

Drag

Tritt ein, wenn der Benutzer Text an bestimmte Positionen zieht.

DragEnd

Tritt ein, wenn ein Benutzer einen Ziehvorgang beendet.

DragLeave

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

DragOver

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

Focusing

Tritt ein, wenn das Element erstmalig den Benutzereingabefokus erhält.

GotFocus

Tritt ein, wenn das Element den Benutzereingabefokus erhalten hat.

KeyDown

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

KeyPress

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

KeyUp

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

LosingFocus

Tritt ein, wenn der Benutzereingabefokus vom Element entfernt wird.

LostFocus

Tritt ein, wenn der Benutzereingabefokus vom Element entfernt wurde.

MouseDown

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

MouseEnter

Tritt ein, wenn der Benutzer erstmalig den Mauszeiger über das aktuelle Element bewegt.

MouseLeave

Tritt ein, wenn der Benutzer den Mauszeiger fort vom aktuellen Element bewegt.

MouseMove

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

MouseOver

Tritt ein, wenn der Mauszeiger in die Grenzen des Elements eintritt.

MouseUp

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

Gilt für

Siehe auch