HtmlElement Classe

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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