HtmlElement Classe

Définition

Représente un élément HTML dans une page Web.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
Héritage
HtmlElement

Exemples

L’exemple de code suivant montre comment examiner un document HTML arbitraire et comment dériver une chaîne décrivant les éléments HTML, avec la mise en retrait et les numéros de niveau utilisés pour indiquer la profondeur d’imbrication des éléments dans le document.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. Cet exemple de code requiert que votre application héberge WebBrowser un contrôle WebBrowser1nommé.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

Remarques

HtmlElementreprésente n’importe quel type d’élément possible dans un document HTML, BODYtel TABLEque, FORMet, entre autres.HtmlElement represents any possible type of element in an HTML document, such as BODY, TABLE, and FORM, among others. La classe expose les propriétés les plus courantes que vous pouvez vous attendre à trouver sur tous les éléments.The class exposes the most common properties you can expect to find on all elements.

La plupart des éléments peuvent avoir des éléments enfants: d’autres éléments HTML placés sous-jacents.Most elements can have child elements: other HTML elements that are placed underneath them. Utilisez la CanHaveChildren propriété pour tester si un élément donné a des enfants, et Children la collection pour les itérer.Use the CanHaveChildren property to test whether a given element has children, and the Children collection to iterate through them. La Parent propriété retourne le HtmlElement dans lequel l’élément actuel est imbriqué.The Parent property returns the HtmlElement in which the current element is nested.

Vous devez souvent accéder à des attributs, des propriétés et des méthodes sur l’élément sous-jacent qui ne HtmlElementsont pas directement exposés SRC par, tels IMG que l’attribut Submit sur un élément FORMou la méthode sur un.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. Les GetAttribute méthodes SetAttribute et vous permettent de récupérer et de modifier un attribut ou une propriété sur un élément spécifique InvokeMember , tandis que permet d’accéder à toute méthode non exposée dans le document Object Model managé (DOM).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). Si votre application dispose d’une autorisation de code non managé, vous pouvez également accéder aux propriétés et méthodes non DomElement exposées avec l’attribut.If your application has unmanaged code permission, you can also access unexposed properties and methods with the DomElement attribute.

Utilisez la TagName propriété pour déterminer si un élément est d’un type spécifique.Use the TagName property to test whether an element is of a specific type.

Tout document HTML peut être modifié au moment de l’exécution.Any HTML document can be modified at run time. Vous HtmlElement pouvez créer des objets avec la CreateElement méthode de HtmlDocument AppendChild et les ajouter à un autre élément à l’aide InsertAdjacentElement des méthodes ou.You can create new HtmlElement objects with the CreateElement method of HtmlDocument, and add them to another element using the AppendChild or InsertAdjacentElement methods. Vous pouvez également créer les éléments en tant que balises HTML et les assigner InnerHtml à la propriété d’un élément existant.You can also create the elements as HTML tags and assign them to an existing element's InnerHtml property.

Propriétés

All

Obtient un HtmlElementCollection de tous les éléments situés sous l'élément actuel.Gets an HtmlElementCollection of all elements underneath the current element.

CanHaveChildren

Obtient une valeur indiquant si cet élément peut avoir des éléments enfants.Gets a value indicating whether this element can have child elements.

Children

Obtient un HtmlElementCollection de tous les enfants de l'élément actuel.Gets an HtmlElementCollection of all children of the current element.

ClientRectangle

Obtient les limites de la zone client de l'élément dans le document HTML.Gets the bounds of the client area of the element in the HTML document.

Document

Obtient le HtmlDocument auquel cet élément appartient.Gets the HtmlDocument to which this element belongs.

DomElement

Obtient un pointeur d'interface non managée pour cet élément.Gets an unmanaged interface pointer for this element.

Enabled

Obtient ou définit si l'utilisateur peut entrer des données dans cet élément.Gets or sets whether the user can input data into this element.

FirstChild

Obtient l'élément suivant situé au-dessous de cet élément dans l'arborescence du document.Gets the next element below this element in the document tree.

Id

Obtient ou définit une étiquette qui sert à identifier l'élément.Gets or sets a label by which to identify the element.

InnerHtml

Obtient ou définit le balisage HTML sous cet élément.Gets or sets the HTML markup underneath this element.

InnerText

Obtient ou définit le texte assigné à l'élément.Gets or sets the text assigned to the element.

Name

Obtient ou définit le nom de l'élément.Gets or sets the name of the element.

NextSibling

Obtient l'élément suivant situé au même niveau que cet élément dans l'arborescence du document.Gets the next element at the same level as this element in the document tree.

OffsetParent

Obtient l'élément à partir duquel OffsetRectangle est calculé.Gets the element from which OffsetRectangle is calculated.

OffsetRectangle

Obtient l'emplacement d'un élément par rapport à son parent.Gets the location of an element relative to its parent.

OuterHtml

Obtient ou définit le code HTML de l'élément actuel.Gets or sets the current element's HTML code.

OuterText

Obtient ou définit le texte de l'élément actuel.Gets or sets the current element's text.

Parent

Obtient l'élément parent de l'élément actuel.Gets the current element's parent element.

ScrollLeft

Obtient ou définit la distance entre le bord de l'élément et le bord gauche de son contenu.Gets or sets the distance between the edge of the element and the left edge of its content.

ScrollRectangle

Obtient les dimensions de la région défilante d'un élément.Gets the dimensions of an element's scrollable region.

ScrollTop

Obtient ou définit la distance entre le bord de l'élément et le bord supérieur de son contenu.Gets or sets the distance between the edge of the element and the top edge of its content.

Style

Obtient ou définit une liste délimitée par des virgules de styles pour l’élément actuel.Gets or sets a semicolon-delimited list of styles for the current element.

TabIndex

Obtient ou définit l'emplacement de cet élément dans l'ordre de tabulation.Gets or sets the location of this element in the tab order.

TagName

Obtient le nom de la balise HTML.Gets the name of the HTML tag.

Méthodes

AppendChild(HtmlElement)

Ajoute un élément au sous-arbre d'un autre élément.Adds an element to another element's subtree.

AttachEventHandler(String, EventHandler)

Ajoute un gestionnaire d'événements pour un événement nommé sur le modèle DOM HTML.Adds an event handler for a named event on the HTML Document Object Model (DOM).

DetachEventHandler(String, EventHandler)

Supprime un gestionnaire d'événements d'un événement nommé sur le modèle DOM HTML.Removes an event handler from a named event on the HTML Document Object Model (DOM).

Equals(Object)

Teste si l'objet fourni est égal à l'élément actuel.Tests if the supplied object is equal to the current element.

Focus()

Met le focus d'entrée d'utilisateur sur l'élément actuel.Puts user input focus on the current element.

GetAttribute(String)

Récupère la valeur de l'attribut nommé sur l'élément.Retrieves the value of the named attribute on the element.

GetElementsByTagName(String)

Récupère une collection d’éléments représentée en HTML par l’étiquette HTML spécifiée.Retrieves a collection of elements represented in HTML by the specified HTML tag.

GetHashCode()

Sert de fonction de hachage pour un type particulier.Serves as a hash function for a particular type.

GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

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

Insère un nouvel élément dans le modèle DOM.Insert a new element into the Document Object Model (DOM).

InvokeMember(String)

Exécute une méthode non exposée dans l'élément DOM sous-jacent de cet élément.Executes an unexposed method on the underlying DOM element of this element.

InvokeMember(String, Object[])

Exécute une fonction définie dans la page HTML actuelle par un langage de script.Executes a function defined in the current HTML page by a scripting language.

MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

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

Provoque l'appel à tous les gestionnaires d'événements enregistrés par l'événement nommé.Causes the named event to call all registered event handlers.

RemoveFocus()

Supprime le focus de l'élément actuel, si cet élément a le focus.Removes focus from the current element, if that element has 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.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)

Définit la valeur de l'attribut nommé sur l'élément.Sets the value of the named attribute on the element.

ToString()

Retourne une chaîne qui représente l'objet en cours.Returns a string that represents the current object.

(Hérité de Object)

Opérateurs

Equality(HtmlElement, HtmlElement)

Compare si deux éléments sont égaux.Compares two elements for equality.

Inequality(HtmlElement, HtmlElement)

Compare deux objets HtmlElement pour déterminer s'ils sont différents.Compares two HtmlElement objects for inequality.

Événements

Click

Se produit lorsque l'utilisateur clique sur l'élément avec le bouton gauche de la souris.Occurs when the user clicks on the element with the left mouse button.

DoubleClick

Se produit lorsque l'utilisateur clique deux fois de suite avec le bouton gauche de la souris sur un élément.Occurs when the user clicks the left mouse button over an element twice, in rapid succession.

Drag

Se produit lorsque l'utilisateur fait glisser le texte vers plusieurs emplacements.Occurs when the user drags text to various locations.

DragEnd

Se produit lorsqu'un utilisateur termine une opération glisser.Occurs when a user finishes a drag operation.

DragLeave

Se produit lorsque l'utilisateur ne fait plus glisser un élément sur cet élément.Occurs when the user is no longer dragging an item over this element.

DragOver

Se produit lorsque l'utilisateur fait glisser du texte sur l'élément.Occurs when the user drags text over the element.

Focusing

Se produit lorsque l'élément reçoit en premier le focus d'entrée d'utilisateur.Occurs when the element first receives user input focus.

GotFocus

Se produit lorsque l'élément a reçu le focus d'entrée d'utilisateur.Occurs when the element has received user input focus.

KeyDown

Se produit lorsque l'utilisateur appuie sur une touche du clavier.Occurs when the user presses a key on the keyboard.

KeyPress

Se produit lorsque l'utilisateur appuie sur une touche du clavier et la relâche.Occurs when the user presses and releases a key on the keyboard.

KeyUp

Se produit lorsque l'utilisateur relâche une touche du clavier.Occurs when the user releases a key on the keyboard.

LosingFocus

Se produit lorsque l'élément perd le focus d'entrée d'utilisateur.Occurs when the element is losing user input focus.

LostFocus

Se produit lorsque l'élément a perdu le focus d'entrée d'utilisateur.Occurs when the element has lost user input focus.

MouseDown

Se produit lorsque l'utilisateur appuie sur un bouton de la souris.Occurs when the user presses a mouse button.

MouseEnter

Se produit lorsque l'utilisateur déplace d'abord le curseur de souris sur l'élément actuel.Occurs when the user first moves the mouse cursor over the current element.

MouseLeave

Se produit lorsque l'utilisateur retire le curseur de la souris de l'élément actuel.Occurs when the user moves the mouse cursor off of the current element.

MouseMove

Se produit lorsque l'utilisateur déplace le curseur de la souris sur l'élément.Occurs when the user moves the mouse cursor across the element.

MouseOver

Se produit lorsque le curseur de souris passe les limites de l'élément.Occurs when the mouse cursor enters the bounds of the element.

MouseUp

Se produit lorsque l'utilisateur relâche un bouton de la souris.Occurs when the user releases a mouse button.

S’applique à

Voir aussi