HtmlElement Klasse
Definition
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
-
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 |
| 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. |