Partager via


HtmlElement Classe

Définition

Représente un élément HTML dans une page web.

public ref class HtmlElement sealed
public sealed class HtmlElement
type HtmlElement = class
Public NotInheritable Class HtmlElement
Héritage
HtmlElement

Exemples

L’exemple de code suivant montre comment examiner un document HTML arbitraire et dériver une chaîne décrivant les éléments HTML, avec des nombres de retrait et de niveau utilisés pour indiquer comment les éléments imbriqués profondément sont dans le document. Cet exemple de code nécessite que votre application héberge un WebBrowser contrôle nommé 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

Remarques

HtmlElement représente tout type d’élément possible dans un document HTML, tel que BODY, TABLEet FORM, entre autres. La classe expose les propriétés les plus courantes que vous pouvez rechercher sur tous les éléments.

La plupart des éléments peuvent avoir des éléments enfants : d’autres éléments HTML placés sous eux. Utilisez la CanHaveChildren propriété pour tester si un élément donné a des enfants et la Children collection pour itérer à travers eux. La Parent propriété retourne la HtmlElement valeur dans laquelle l’élément actuel est imbriqué.

Vous avez souvent besoin d’accéder à des attributs, des propriétés et des méthodes sur l’élément sous-jacent qui ne sont pas directement exposés HtmlElementpar , comme l’attribut SRC sur un IMG élément ou la Submit méthode sur un FORM. Les GetAttribute méthodes et SetAttribute les méthodes vous permettent de récupérer et de modifier n’importe quel attribut ou propriété sur un élément spécifique, tandis que InvokeMember fournit l’accès à toutes les méthodes non exposées dans le modèle d’objet de document managé (DOM). Si votre application dispose d’une autorisation de code non managée, vous pouvez également accéder aux propriétés et méthodes non exposées avec l’attribut DomElement .

Utilisez la TagName propriété pour tester si un élément est d’un type spécifique.

Tout document HTML peut être modifié au moment de l’exécution. Vous pouvez créer de nouveaux HtmlElement objets avec la CreateElement méthode de HtmlDocument, et les ajouter à un autre élément à l’aide des méthodes ou InsertAdjacentElement des AppendChild méthodes. Vous pouvez également créer les éléments en tant que balises HTML et les affecter à la propriété d’un InnerHtml élément existant.

Propriétés

All

Obtient un HtmlElementCollection de tous les éléments situés sous l'élément actuel.

CanHaveChildren

Obtient une valeur indiquant si cet élément peut avoir des éléments enfants.

Children

Obtient un HtmlElementCollection de tous les enfants de l'élément actuel.

ClientRectangle

Obtient les limites de la zone client de l'élément dans le document HTML.

Document

Obtient le HtmlDocument auquel cet élément appartient.

DomElement

Obtient un pointeur d'interface non managée pour cet élément.

Enabled

Obtient ou définit si l'utilisateur peut entrer des données dans cet élément.

FirstChild

Obtient l’élément suivant situé au-dessous de cet élément dans l’arborescence du document.

Id

Obtient ou définit une étiquette qui sert à identifier l'élément.

InnerHtml

Obtient ou définit le balisage HTML sous cet élément.

InnerText

Obtient ou définit le texte assigné à l'élément.

Name

Obtient ou définit le nom de l'élément.

NextSibling

Obtient l'élément suivant situé au même niveau que cet élément dans l'arborescence du document.

OffsetParent

Obtient l'élément à partir duquel OffsetRectangle est calculé.

OffsetRectangle

Obtient l'emplacement d'un élément par rapport à son parent.

OuterHtml

Obtient ou définit le code HTML de l'élément actuel.

OuterText

Obtient ou définit le texte de l'élément actuel.

Parent

Obtient l'élément parent de l'élément actuel.

ScrollLeft

Obtient ou définit la distance entre le bord de l'élément et le bord gauche de son contenu.

ScrollRectangle

Obtient les dimensions de la région défilante d'un élément.

ScrollTop

Obtient ou définit la distance entre le bord de l'élément et le bord supérieur de son contenu.

Style

Obtient ou définit une liste délimitée par des virgules de styles pour l’élément actuel.

TabIndex

Obtient ou définit l'emplacement de cet élément dans l'ordre de tabulation.

TagName

Obtient le nom de l’étiquette HTML.

Méthodes

AppendChild(HtmlElement)

Ajoute un élément au sous-arbre d'un autre élément.

AttachEventHandler(String, EventHandler)

Ajoute un gestionnaire d'événements pour un événement nommé sur le modèle DOM HTML.

DetachEventHandler(String, EventHandler)

Supprime un gestionnaire d'événements d'un événement nommé sur le modèle DOM HTML.

Equals(Object)

Teste si l'objet fourni est égal à l'élément actuel.

Focus()

Met le focus d'entrée d'utilisateur sur l'élément actuel.

GetAttribute(String)

Récupère la valeur de l'attribut nommé sur l'élément.

GetElementsByTagName(String)

Récupère une collection d’éléments représentée en HTML par l’étiquette HTML spécifiée.

GetHashCode()

Sert de fonction de hachage pour un type particulier.

GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
InsertAdjacentElement(HtmlElementInsertionOrientation, HtmlElement)

Insère un nouvel élément dans le modèle DOM.

InvokeMember(String)

Exécute une méthode non exposée dans l'élément DOM sous-jacent de cet élément.

InvokeMember(String, Object[])

Exécute une fonction définie dans la page HTML actuelle par un langage de script.

MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
RaiseEvent(String)

Provoque l'appel de tous les gestionnaires d'événements enregistrés par l'événement nommé.

RemoveFocus()

Supprime le focus de l'élément actuel, si cet élément a le focus.

ScrollIntoView(Boolean)

Fait défiler le document qui contient cet élément jusqu'à ce que le bord supérieur ou inférieur de cet élément soit aligné avec la fenêtre du document.

SetAttribute(String, String)

Définit la valeur de l'attribut nommé sur l'élément.

ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

Opérateurs

Equality(HtmlElement, HtmlElement)

Compare deux éléments pour déterminer s'ils sont égaux.

Inequality(HtmlElement, HtmlElement)

Compare deux objets HtmlElement pour déterminer s'ils sont différents.

Événements

Click

Se produit lorsque l'utilisateur clique sur l'élément avec le bouton gauche de la souris.

DoubleClick

Se produit lorsque l'utilisateur clique deux fois de suite avec le bouton gauche de la souris sur un élément.

Drag

Se produit quand l'utilisateur fait glisser le texte vers plusieurs emplacements.

DragEnd

Se produit lorsqu'un utilisateur termine une opération glisser.

DragLeave

Se produit lorsque l'utilisateur ne fait plus glisser un élément sur cet élément.

DragOver

Se produit lorsque l'utilisateur fait glisser du texte sur l'élément.

Focusing

Se produit lorsque l'élément reçoit pour la première fois le focus d'entrée utilisateur.

GotFocus

Se produit lorsque l'élément a reçu le focus d'entrée d'utilisateur.

KeyDown

Se produit lorsque l'utilisateur appuie sur une touche du clavier.

KeyPress

Se produit lorsque l'utilisateur appuie sur une touche du clavier et la relâche.

KeyUp

Se produit lorsque l’utilisateur relâche une touche du clavier.

LosingFocus

Se produit quand l'élément perd le focus d'entrée utilisateur.

LostFocus

Se produit quand l'élément a perdu le focus d'entrée utilisateur.

MouseDown

Se produit lorsque l'utilisateur appuie sur un bouton de la souris.

MouseEnter

Se produit quand l'utilisateur déplace pour la première fois le curseur de la souris sur l'élément actuel.

MouseLeave

Se produit quand l'utilisateur retire le curseur de la souris de l'élément actuel.

MouseMove

Se produit lorsque l'utilisateur déplace le curseur de la souris sur l'élément.

MouseOver

Se produit lorsque le curseur de souris passe les limites de l'élément.

MouseUp

Se produit lorsque l’utilisateur relâche un bouton de la souris.

S’applique à

Voir aussi