HtmlElement HtmlElement HtmlElement HtmlElement Class

Definition

Stellt ein HTML-Element innerhalb einer Webseite dar.Represents an HTML element inside of a Web page.

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

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie auf ein beliebiges HTML-Dokument zu untersuchen und leiten Sie eine Zeichenfolge enthält, die HTML-Elemente mit Einzug und angegeben wird, wie tief anzugeben geschachtelte Elemente im Dokument sind.The following code example shows how to examine an arbitrary HTML document and derive a string describing the HTML elements, with indentation and level numbers used to indicate how deeply nested the elements are in the document. Dieses Codebeispiel erfordert, dass Ihre Anwendungshosts eine WebBrowser Steuerelement mit dem Namen WebBrowser1.This code example requires that your application hosts a WebBrowser control named 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.HtmlElement represents any possible type of element in an HTML document, such as BODY, TABLE, and FORM, among others. Die Klasse stellt die am häufigsten verwendeten Eigenschaften, die Sie erwarten können, um für alle Elemente zu finden.The class exposes the most common properties you can expect to find on all elements.

Die meisten Elemente haben untergeordnete Elemente: andere HTML-Elemente, die unterhalb der Steuerelemente platziert werden.Most elements can have child elements: other HTML elements that are placed underneath them. Verwenden der CanHaveChildren Eigenschaft zu prüfen, ob ein angegebenes Element untergeordneten Elemente verfügt und die Children Auflistung durchlaufen werden.Use the CanHaveChildren property to test whether a given element has children, and the Children collection to iterate through them. Die Parent -Eigenschaft gibt die HtmlElement in dem das aktuelle Element geschachtelt ist.The Parent property returns the HtmlElement in which the current element is nested.

Benötigen Sie häufig Zugriff auf Attribute, Eigenschaften und Methoden für das zugrunde liegende Element, das vom nicht direkt verfügbar gemacht werden HtmlElement, z. B. die SRC -Attribut für ein IMG Element oder die Submit Methode für eine FORM.You often need access to attributes, properties, and methods on the underlying element that are not directly exposed by HtmlElement, such as the SRC attribute on an IMG element or the Submit method on a FORM. Die GetAttribute und SetAttribute Methoden ermöglichen das Abrufen und ändern jedes Attribut und die Eigenschaft für ein bestimmtes Element, während InvokeMember ermöglicht den Zugriff auf alle Methoden, die in der verwalteten (DOKUMENTOBJEKTMODELL) nicht verfügbar.The GetAttribute and SetAttribute methods enable you to retrieve and alter any attribute or property on a specific element, while InvokeMember provides access to any methods not exposed in the managed Document Object Model (DOM). Wenn Ihre Anwendung nicht die Berechtigung für Code verwaltet wurde, können Sie auch aufrufen nicht verfügbar gemachte Eigenschaften und Methoden mit dem DomElement Attribut.If your application has unmanaged code permission, you can also access unexposed properties and methods with the DomElement attribute.

Verwenden der TagName Eigenschaft zu prüfen, ob ein Element eines bestimmten Typs ist.Use the TagName property to test whether an element is of a specific type.

Alle HTML-Dokument kann zur Laufzeit geändert werden.Any HTML document can be modified at run time. Sie können neue erstellen HtmlElement Objekte mit der CreateElement -Methode der HtmlDocument, und fügen sie ein anderes Element mit der AppendChild oder InsertAdjacentElement Methoden.You can create new HtmlElement objects with the CreateElement method of HtmlDocument, and add them to another element using the AppendChild or InsertAdjacentElement methods. Sie können auch die Elemente als HTML-Tags erstellen und weisen sie Sie eines vorhandenen Elements InnerHtml Eigenschaft.You can also create the elements as HTML tags and assign them to an existing element's InnerHtml property.

Eigenschaften

All All All All

Ruft eine HtmlElementCollection aller Elemente unterhalb des aktuellen Elements ab.Gets an HtmlElementCollection of all elements underneath the current element.

CanHaveChildren CanHaveChildren CanHaveChildren CanHaveChildren

Ruft einen Wert ab, der angibt, ob dieses Element über untergeordnete Elemente verfügen kann.Gets a value indicating whether this element can have child elements.

Children Children Children Children

Ruft eine HtmlElementCollection aller untergeordneten Elemente des aktuellen Elements ab.Gets an HtmlElementCollection of all children of the current element.

ClientRectangle ClientRectangle ClientRectangle ClientRectangle

Ruft die Grenzen des Clientbereichs des Elements im HTML-Dokument ab.Gets the bounds of the client area of the element in the HTML document.

Document Document Document Document

Ruft das HtmlDocument ab, zu dem dieses Element gehört.Gets the HtmlDocument to which this element belongs.

DomElement DomElement DomElement DomElement

Ruft einen nicht verwalteten Schnittstellenzeiger für dieses Element ab.Gets an unmanaged interface pointer for this element.

Enabled Enabled Enabled Enabled

Ruft ab oder legt fest, ob der Benutzer Daten in dieses Element eingeben kann.Gets or sets whether the user can input data into this element.

FirstChild FirstChild FirstChild FirstChild

Ruft das nächste Element unter diesem Element in der Dokumentstruktur ab.Gets the next element below this element in the document tree.

Id Id Id Id

Ruft eine Bezeichnung ab, durch die das Element identifiziert werden soll, oder legt diese fest.Gets or sets a label by which to identify the element.

InnerHtml InnerHtml InnerHtml InnerHtml

Ruft das HTML-Markup unter diesem Element ab oder legt es fest.Gets or sets the HTML markup underneath this element.

InnerText InnerText InnerText InnerText

Ruft den dem Element zugewiesenen Text ab oder legt diesen fest.Gets or sets the text assigned to the element.

Name Name Name Name

Ruft den Namen des Elements ab oder legt diesen fest.Gets or sets the name of the element.

NextSibling NextSibling NextSibling NextSibling

Ruft das nächste Element auf der gleichen Ebene wie dieses Element in der Dokumentstruktur ab.Gets the next element at the same level as this element in the document tree.

OffsetParent OffsetParent OffsetParent OffsetParent

Ruft das Element ab, aus dem OffsetRectangle berechnet wird.Gets the element from which OffsetRectangle is calculated.

OffsetRectangle OffsetRectangle OffsetRectangle OffsetRectangle

Ruft die Position eines Elements relativ zu seinem übergeordneten Element ab.Gets the location of an element relative to its parent.

OuterHtml OuterHtml OuterHtml OuterHtml

Ruft den HTML-Code des aktuellen Elements ab oder legt diesen fest.Gets or sets the current element's HTML code.

OuterText OuterText OuterText OuterText

Ruft den Text des aktuellen Elements ab oder legt diesen fest.Gets or sets the current element's text.

Parent Parent Parent Parent

Ruft das übergeordnete Element des aktuellen Elements ab.Gets the current element's parent element.

ScrollLeft ScrollLeft ScrollLeft ScrollLeft

Ruft den Abstand zwischen dem Rand des Elements und dem linken Rand seines Inhalts ab oder legt diesen fest.Gets or sets the distance between the edge of the element and the left edge of its content.

ScrollRectangle ScrollRectangle ScrollRectangle ScrollRectangle

Ruft die Dimensionen des bildlauffähigen Bereichs eines Elements ab.Gets the dimensions of an element's scrollable region.

ScrollTop ScrollTop ScrollTop ScrollTop

Ruft den Abstand zwischen dem Rand des Elements und dem oberen Rand seines Inhalts ab oder legt diesen fest.Gets or sets the distance between the edge of the element and the top edge of its content.

Style Style Style Style

Ruft eine durch Semikola getrennte Liste der Formate für das aktuelle Element ab oder legt diese fest.Gets or sets a semicolon-delimited list of styles for the current element.

TabIndex TabIndex TabIndex TabIndex

Ruft die Position dieses Elements in der Aktivierreihenfolge ab oder legt diese fest.Gets or sets the location of this element in the tab order.

TagName TagName TagName TagName

Ruft den Namen des HTML-Tags ab.Gets the name of the HTML tag.

Methoden

AppendChild(HtmlElement) AppendChild(HtmlElement) AppendChild(HtmlElement) AppendChild(HtmlElement)

Fügt der Teilstruktur eines Elements ein anderes Element hinzu.Adds an element to another element's subtree.

AttachEventHandler(String, EventHandler) AttachEventHandler(String, EventHandler) AttachEventHandler(String, EventHandler) AttachEventHandler(String, EventHandler)

Fügt im HTML-DOM (Document Object Model) einen Ereignishandler für ein benanntes Ereignis hinzu.Adds an event handler for a named event on the HTML Document Object Model (DOM).

DetachEventHandler(String, EventHandler) DetachEventHandler(String, EventHandler) DetachEventHandler(String, EventHandler) DetachEventHandler(String, EventHandler)

Entfernt einen Ereignishandler von einem benannten Ereignis im HTML-DOM (Document Object Model).Removes an event handler from a named event on the HTML Document Object Model (DOM).

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Überprüft, ob das angegebene Objekt gleich dem aktuellen Element ist.Tests if the supplied object is equal to the current element.

Focus() Focus() Focus() Focus()

Legt den Benutzereingabefokus auf das aktuelle Element fest.Puts user input focus on the current element.

GetAttribute(String) GetAttribute(String) GetAttribute(String) GetAttribute(String)

Ruft den Wert des benannten Attributs im Element ab.Retrieves the value of the named attribute on the element.

GetElementsByTagName(String) GetElementsByTagName(String) GetElementsByTagName(String) GetElementsByTagName(String)

Ruft eine Auflistung von Elementen ab, die in HTML durch das angegebene HTML-Tag dargestellt sind.Retrieves a collection of elements represented in HTML by the specified HTML tag.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Hashfunktion für einen besonderen Typ.Serves as a hash function for a particular type.

GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
InsertAdjacentElement(HtmlElementInsertionOrientation, HtmlElement) InsertAdjacentElement(HtmlElementInsertionOrientation, HtmlElement) InsertAdjacentElement(HtmlElementInsertionOrientation, HtmlElement) InsertAdjacentElement(HtmlElementInsertionOrientation, HtmlElement)

Fügt ein neues Element in das DOM (Document Object Model) ein.Insert a new element into the Document Object Model (DOM).

InvokeMember(String) InvokeMember(String) InvokeMember(String) InvokeMember(String)

Führt eine nicht verfügbar gemachte Methode für das zugrunde liegende DOM-Element dieses Elements aus.Executes an unexposed method on the underlying DOM element of this element.

InvokeMember(String, Object[]) InvokeMember(String, Object[]) InvokeMember(String, Object[]) InvokeMember(String, Object[])

Führt eine in der aktuellen HTML-Seite von einer Skriptsprache definierte Funktion aus.Executes a function defined in the current HTML page by a scripting language.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
RaiseEvent(String) RaiseEvent(String) RaiseEvent(String) RaiseEvent(String)

Bewirkt, dass das benannte Ereignis alle registrierten Ereignishandler aufruft.Causes the named event to call all registered event handlers.

RemoveFocus() RemoveFocus() RemoveFocus() RemoveFocus()

Entfernt den Fokus vom aktuellen Element, wenn dieses Element den Fokus besitzt.Removes focus from the current element, if that element has focus.

ScrollIntoView(Boolean) ScrollIntoView(Boolean) ScrollIntoView(Boolean) 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.Scrolls through the document containing this element until the top or bottom edge of this element is aligned with the document's window.

SetAttribute(String, String) SetAttribute(String, String) SetAttribute(String, String) SetAttribute(String, String)

Legt den Wert des benannten Attributs für das Element fest.Sets the value of the named attribute on the element.

ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Ereignisse

Click Click Click Click

Tritt ein, wenn der Benutzer mit der linken Maustaste auf das Element klickt.Occurs when the user clicks on the element with the left mouse button.

DoubleClick DoubleClick DoubleClick DoubleClick

Tritt ein, wenn der Benutzer zweimal in rascher Folge mit der linken Maustaste auf ein Element klickt.Occurs when the user clicks the left mouse button over an element twice, in rapid succession.

Drag Drag Drag Drag

Tritt ein, wenn der Benutzer Text an bestimmte Positionen zieht.Occurs when the user drags text to various locations.

DragEnd DragEnd DragEnd DragEnd

Tritt ein, wenn ein Benutzer einen Ziehvorgang beendet.Occurs when a user finishes a drag operation.

DragLeave DragLeave DragLeave DragLeave

Tritt ein, wenn der Benutzer kein Element mehr über dieses Element zieht.Occurs when the user is no longer dragging an item over this element.

DragOver DragOver DragOver DragOver

Tritt ein, wenn der Benutzer Text über das Element zieht.Occurs when the user drags text over the element.

Focusing Focusing Focusing Focusing

Tritt ein, wenn das Element erstmalig den Benutzereingabefokus erhält.Occurs when the element first receives user input focus.

GotFocus GotFocus GotFocus GotFocus

Tritt ein, wenn das Element den Benutzereingabefokus erhalten hat.Occurs when the element has received user input focus.

KeyDown KeyDown KeyDown KeyDown

Tritt ein, wenn der Benutzer eine Taste auf der Tastatur drückt.Occurs when the user presses a key on the keyboard.

KeyPress KeyPress KeyPress KeyPress

Tritt ein, wenn der Benutzer eine Taste auf der Tastatur drückt und wieder loslässt.Occurs when the user presses and releases a key on the keyboard.

KeyUp KeyUp KeyUp KeyUp

Tritt ein, wenn der Benutzer eine Taste auf der Tastatur loslässt.Occurs when the user releases a key on the keyboard.

LosingFocus LosingFocus LosingFocus LosingFocus

Tritt ein, wenn der Benutzereingabefokus vom Element entfernt wird.Occurs when the element is losing user input focus.

LostFocus LostFocus LostFocus LostFocus

Tritt ein, wenn der Benutzereingabefokus vom Element entfernt wurde.Occurs when the element has lost user input focus.

MouseDown MouseDown MouseDown MouseDown

Tritt ein, wenn der Benutzer eine Maustaste drückt.Occurs when the user presses a mouse button.

MouseEnter MouseEnter MouseEnter MouseEnter

Tritt ein, wenn der Benutzer erstmalig den Mauszeiger über das aktuelle Element bewegt.Occurs when the user first moves the mouse cursor over the current element.

MouseLeave MouseLeave MouseLeave MouseLeave

Tritt ein, wenn der Benutzer den Mauszeiger fort vom aktuellen Element bewegt.Occurs when the user moves the mouse cursor off of the current element.

MouseMove MouseMove MouseMove MouseMove

Tritt ein, wenn der Benutzer den Mauszeiger über ein Element bewegt.Occurs when the user moves the mouse cursor across the element.

MouseOver MouseOver MouseOver MouseOver

Tritt ein, wenn der Mauszeiger in die Grenzen des Elements eintritt.Occurs when the mouse cursor enters the bounds of the element.

MouseUp MouseUp MouseUp MouseUp

Tritt ein, wenn der Benutzer eine Maustaste loslässt.Occurs when the user releases a mouse button.

Operatoren

Equality(HtmlElement, HtmlElement) Equality(HtmlElement, HtmlElement) Equality(HtmlElement, HtmlElement) Equality(HtmlElement, HtmlElement)

Überprüft zwei Elemente auf Gleichheit.Compares two elements for equality.

Inequality(HtmlElement, HtmlElement) Inequality(HtmlElement, HtmlElement) Inequality(HtmlElement, HtmlElement) Inequality(HtmlElement, HtmlElement)

Überprüft zwei HtmlElement-Objekte auf Ungleichheit.Compares two HtmlElement objects for inequality.

Gilt für:

Siehe auch