HtmlElement Klasse

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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: Object
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