HtmlDocument HtmlDocument HtmlDocument HtmlDocument Class

Définition

Fournit l'accès par programmation de niveau supérieur à un document HTML hébergé par le contrôle WebBrowser.Provides top-level programmatic access to an HTML document hosted by the WebBrowser control.

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

Exemples

L’exemple de code suivant utilise des données à partir de la base de données Northwind pour créer un HTML TABLE dynamiquement à l’aide CreateElement.The following code example uses data from the Northwind database to create an HTML TABLE dynamically using CreateElement. Le AppendChild méthode est également utilisée, tout d’abord pour ajouter des cellules (TD éléments) aux lignes (TR éléments), puis pour ajouter des lignes à la table et enfin pour ajouter le tableau à la fin du document actif.The AppendChild method is also used, first to add cells (TD elements) to rows (TR elements), then to add rows to the table, and finally to append the table to the end of the current document. L’exemple de code requiert que votre application possède un WebBrowser contrôle nommé WebBrowser1.The code example requires that your application has a WebBrowser control named WebBrowser1. Le code doit être appelé après le chargement d’un document.The code should be called after a document has been loaded.

private void DisplayCustomersTable()
{
    DataSet customersSet = new DataSet();
    DataTable customersTable = null;
    SqlDataAdapter sda = new SqlDataAdapter("SELECT * FROM Customers", "Data Source=localhost;Integrated Security=SSPI;Initial Catalog=Northwind;");
    sda.Fill(customersTable);
    customersTable = customersSet.Tables[0];

    if (webBrowser1.Document != null)
    {
        HtmlElement tableRow = null;
        HtmlElement headerElem = null;

        HtmlDocument doc = webBrowser1.Document;
        HtmlElement tableElem = doc.CreateElement("TABLE");
        doc.Body.AppendChild(tableElem);

        HtmlElement tableHeader = doc.CreateElement("THEAD");
        tableElem.AppendChild(tableHeader);
        tableRow = doc.CreateElement("TR");
        tableHeader.AppendChild(tableRow);

        foreach (DataColumn col in customersTable.Columns)
        {
            headerElem = doc.CreateElement("TH");
            headerElem.InnerText = col.ColumnName;
            tableRow.AppendChild(headerElem);
        }

        // Create table rows.
        HtmlElement tableBody = doc.CreateElement("TBODY");
        tableElem.AppendChild(tableBody);
        foreach (DataRow dr in customersTable.Rows)
        {
            tableRow = doc.CreateElement("TR");
            tableBody.AppendChild(tableRow);
            foreach (DataColumn col in customersTable.Columns)
            {
                Object dbCell = dr[col];
                HtmlElement tableCell = doc.CreateElement("TD");
                if (!(dbCell is DBNull))
                {
                    tableCell.InnerText = dbCell.ToString();
                }
                tableRow.AppendChild(tableCell);
            }
        }
    }
}
Private Sub DisplayCustomersTable()
    ' Initialize the database connection.
    Dim CustomerData As New DataSet()
    Dim CustomerTable As DataTable

    Try
        Dim DBConn As New SqlConnection("Data Source=localhost;Integrated Security=SSPI;Initial Catalog=Northwind;")
        Dim DBQuery As New SqlDataAdapter("SELECT * FROM CUSTOMERS", DBConn)
        DBQuery.Fill(CustomerData)
    Catch dbEX As DataException

    End Try

    CustomerTable = CustomerData.Tables("Customers")

    If (Not (WebBrowser1.Document Is Nothing)) Then
        With WebBrowser1.Document
            Dim TableElem As HtmlElement = .CreateElement("TABLE")
            .Body.AppendChild(TableElem)

            Dim TableRow As HtmlElement

            ' Create the table header. 
            Dim TableHeader As HtmlElement = .CreateElement("THEAD")
            TableElem.AppendChild(TableHeader)
            TableRow = .CreateElement("TR")
            TableHeader.AppendChild(TableRow)

            Dim HeaderElem As HtmlElement
            For Each Col As DataColumn In CustomerTable.Columns
                HeaderElem = .CreateElement("TH")
                HeaderElem.InnerText = Col.ColumnName
                TableRow.AppendChild(HeaderElem)
            Next

            ' Create table rows.
            Dim TableBody As HtmlElement = .CreateElement("TBODY")
            TableElem.AppendChild(TableBody)
            For Each Row As DataRow In CustomerTable.Rows
                TableRow = .CreateElement("TR")
                TableBody.AppendChild(TableRow)
                For Each Col As DataColumn In CustomerTable.Columns
                    Dim Item As Object = Row(Col)
                    Dim TableCell As HtmlElement = .CreateElement("TD")
                    If Not (TypeOf (Item) Is DBNull) Then
                        TableCell.InnerText = CStr(Item)
                    End If
                    TableRow.AppendChild(TableCell)
                Next
            Next

        End With
    End If
End Sub

Remarques

HtmlDocument fournit un wrapper managé autour d’objet de document Internet Explorer, également connu sous le HTML modèle DOM (Document Object).HtmlDocument provides a managed wrapper around Internet Explorer's document object, also known as the HTML Document Object Model (DOM). Pour obtenir une instance de HtmlDocument via la Document propriété de la WebBrowser contrôle.You obtain an instance of HtmlDocument through the Document property of the WebBrowser control.

Les balises HTML dans un document HTML peuvent être imbriqués à l’intérieur de l’autre.HTML tags inside of an HTML document can be nested inside one another. HtmlDocument représente donc une arborescence de document, dont les enfants sont des instances de la HtmlElement classe.HtmlDocument thus represents a document tree, whose children are instances of the HtmlElement class. L’exemple de code suivant montre un fichier HTML simple.The following code example shows a simple HTML file.

<HTML>  
    <BODY>  
        <DIV name="Span1">Simple HTML Form</DIV>  
        <FORM>  
            <SPAN name="TextLabel">Enter Your Name:</SPAN>  
            <INPUT type="text" size="20" name="Text1">  
        </FORM>  
    </BODY>  
</HTML>  

Dans cet exemple, HtmlDocument représente le document entier à l’intérieur de la HTML balises.In this example, HtmlDocument represents the entire document inside the HTML tags. Le BODY, DIV, FORM et SPAN balises sont représentées par une personne HtmlElement objets.The BODY, DIV, FORM and SPAN tags are represented by individual HtmlElement objects.

Il existe plusieurs façons, vous pouvez accéder aux éléments de cette arborescence.There are several ways you can access the elements in this tree. Utilisez le Body propriété pour accéder à la BODY balise et tous ses enfants.Use the Body property to access the BODY tag and all of its children. Le ActiveElement propriété vous donne le HtmlElement pour l’élément sur une page HTML qui a le focus d’entrée utilisateur.The ActiveElement property gives you the HtmlElement for the element on an HTML page that has user input focus. Tous les éléments dans une page HTML peuvent avoir un nom ; le All collection fournit l’accès à chaque HtmlElement à l’aide de son nom en tant qu’index.All elements within an HTML page can have a name; the All collection provides access to each HtmlElement using its name as an index. GetElementsByTagName retournera un HtmlElementCollection de tous les HtmlElement objets avec un nom de balise HTML donné, tel que DIV ou TABLE.GetElementsByTagName will return an HtmlElementCollection of all HtmlElement objects with a given HTML tag name, such as DIV or TABLE. GetElementById Retourne le seul HtmlElement correspondant à l’ID unique que vous fournissez.GetElementById will return the single HtmlElement corresponding to the unique ID that you supply. GetElementFromPoint Retourne le HtmlElement qui peut être trouvée sur l’écran aux coordonnées du pointeur de souris fournies.GetElementFromPoint will return the HtmlElement that can be found on the screen at the supplied mouse pointer coordinates.

Vous pouvez également utiliser le Forms et Images collection à itérer les éléments que l’utilisateur représentent entrée formulaires et des graphiques, respectivement.You can also use the Forms and Images collection to iterate through elements that represent user input forms and graphics, respectively.

HtmlDocument est basé sur les interfaces non managées implémentées par le DOM DHTML d’Internet Explorer : IHTMLDocument, IHTMLDocument2, IHTMLDocument3, et IHTMLDocument4.HtmlDocument is based on the unmanaged interfaces implemented by Internet Explorer's DHTML DOM: IHTMLDocument, IHTMLDocument2, IHTMLDocument3, and IHTMLDocument4. Uniquement les propriétés les plus fréquemment utilisés et les méthodes sur ces interfaces non managées sont exposées par HtmlDocument.Only the most frequently used properties and methods on these unmanaged interfaces are exposed by HtmlDocument. Vous pouvez accéder à toutes les autres propriétés et méthodes directement à l’aide de la DomDocument propriété, vous pouvez effectuer un cast vers le pointeur d’interface non managé désiré.You can access all other properties and methods directly using the DomDocument property, which you can cast to the desired unmanaged interface pointer.

Un document HTML peut contenir des frames, qui sont des fenêtres différentes à l’intérieur de la WebBrowser contrôle.An HTML document may contain frames, which are different windows inside of the WebBrowser control. Chaque frame affiche sa propre page HTML.Each frame displays its own HTML page. Le Frames collection est disponible via le Window propriété.The Frames collection is available through the Window property. Vous pouvez également utiliser le Window propriété pour redimensionner la page affichée, faites défiler le document ou afficher des alertes et vous invite à l’utilisateur.You may also use the Window property to resize the displayed page, scroll the document, or display alerts and prompts to the user.

HtmlDocument expose les événements les plus courants que vous rencontrerez lors de l’hébergement de pages HTML.HtmlDocument exposes the most common events you would expect to handle when hosting HTML pages. Pour les événements non exposés directement par l’interface, vous pouvez ajouter un gestionnaire pour l’événement à l’aide AttachEventHandler.For events not exposed directly by the interface, you can add a handler for the event using AttachEventHandler.

Les fichiers HTML peuvent contenir SCRIPT balises qui encapsulent le code écrit dans un des langages Active Scripting, tels que JScript ou VBScript.HTML files may contain SCRIPT tags that encapsulate code written in one of the Active Scripting languages, such as JScript or VBScript. Le InvokeScript méthode permet l’exécution de propriétés et méthodes définies dans un SCRIPT balise.The InvokeScript method provides for execution of properties and methods defined in a SCRIPT tag.

Notes

Alors que la plupart des propriétés, méthodes et événements sur HtmlDocument ont conservé les mêmes noms que sur le DOM non managé, certains ont été modifiés par souci de cohérence avec le .NET Framework.NET Framework.While most of the properties, methods, and events on HtmlDocument have kept the same names as they have on the unmanaged DOM, some have been changed for consistency with the .NET Framework.NET Framework.

Propriétés

ActiveElement ActiveElement ActiveElement ActiveElement

Fournit le HtmlElement qui possède actuellement le focus d'entrée utilisateur.Provides the HtmlElement which currently has user input focus.

ActiveLinkColor ActiveLinkColor ActiveLinkColor ActiveLinkColor

Obtient ou définit le Color d'un lien hypertexte lorsque l'utilisateur clique dessus.Gets or sets the Color of a hyperlink when clicked by a user.

All All All All

Obtient une instance de HtmlElementCollection qui stocke tous les objets HtmlElement pour le document.Gets an instance of HtmlElementCollection, which stores all HtmlElement objects for the document.

BackColor BackColor BackColor BackColor

Obtient ou définit la couleur d'arrière-plan du document HTML.Gets or sets the background color of the HTML document.

Body Body Body Body

Obtient le HtmlElement pour la balise BODY.Gets the HtmlElement for the BODY tag.

Cookie Cookie Cookie Cookie

Obtient ou définit les cookies HTTP associés à ce document.Gets or sets the HTTP cookies associated with this document.

DefaultEncoding DefaultEncoding DefaultEncoding DefaultEncoding

Obtient l'encodage utilisé par défaut pour le document actif.Gets the encoding used by default for the current document.

Domain Domain Domain Domain

Obtient ou définit la chaîne qui décrit le domaine de ce document pour des raisons de sécurité.Gets or sets the string describing the domain of this document for security purposes.

DomDocument DomDocument DomDocument DomDocument

Obtient le pointeur d'interface non managé pour ce HtmlDocument.Gets the unmanaged interface pointer for this HtmlDocument.

Encoding Encoding Encoding Encoding

Obtient ou définit l'encodage de caractères pour ce document.Gets or sets the character encoding for this document.

Focused Focused Focused Focused

Obtient une valeur indiquant si le document a le focus d'entrée utilisateur.Gets a value indicating whether the document has user input focus.

ForeColor ForeColor ForeColor ForeColor

Obtient ou définit la couleur du texte du document.Gets or sets the text color for the document.

Forms Forms Forms Forms

Obtient une collection de tous les éléments <FORM> dans le document.Gets a collection of all of the <FORM> elements in the document.

Images Images Images Images

Obtient une collection de toutes les étiquettes d’image dans le document.Gets a collection of all image tags in the document.

LinkColor LinkColor LinkColor LinkColor

Obtient ou définit la couleur de liens hypertexte.Gets or sets the color of hyperlinks.

Links Links Links Links

Obtient une liste de tous les liens hypertexte dans ce document HTML.Gets a list of all the hyperlinks within this HTML document.

RightToLeft RightToLeft RightToLeft RightToLeft

Obtient ou définit la direction du texte dans le document actif.Gets or sets the direction of text in the current document.

Title Title Title Title

Obtient ou définit la valeur texte de la balise <TITLE> dans le document HTML actif.Gets or sets the text value of the <TITLE> tag in the current HTML document.

Url Url Url Url

Obtient l'URL qui décrit l'emplacement de ce document.Gets the URL describing the location of this document.

VisitedLinkColor VisitedLinkColor VisitedLinkColor VisitedLinkColor

Obtient ou définit la couleur des liens vers les pages HTML que l'utilisateur a déjà visitées.Gets or sets the Color of links to HTML pages that the user has already visited.

Window Window Window Window

Obtient le HtmlWindow associé à ce document.Gets the HtmlWindow associated with this document.

Méthodes

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

Ajoute un gestionnaire d'événements pour l'événement nommé sur le modèle DOM HTML.Adds an event handler for the named HTML DOM event.

CreateElement(String) CreateElement(String) CreateElement(String) CreateElement(String)

Crée un HtmlElement du type de balise HTML spécifié.Creates a new HtmlElement of the specified HTML tag type.

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

Supprime un gestionnaire d'événements d'un événement nommé sur le DOM HTML.Removes an event handler from a named event on the HTML DOM.

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

Teste l'objet pour déterminer s'il est égal à l'objet actif.Tests the object for equality against the current object.

ExecCommand(String, Boolean, Object) ExecCommand(String, Boolean, Object) ExecCommand(String, Boolean, Object) ExecCommand(String, Boolean, Object)

Exécute la commande spécifiée contre le document.Executes the specified command against the document.

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

Définit le focus d'entrée d'utilisateur sur le document actif.Sets user input focus on the current document.

GetElementById(String) GetElementById(String) GetElementById(String) GetElementById(String)

Récupère un HtmlElement en utilisant l’attribut ID de l’élément comme clé de recherche.Retrieves a single HtmlElement using the element's ID attribute as a search key.

GetElementFromPoint(Point) GetElementFromPoint(Point) GetElementFromPoint(Point) GetElementFromPoint(Point)

Récupère l'élément HTML situé aux coordonnées clientes spécifiées.Retrieves the HTML element located at the specified client coordinates.

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

Récupère une collection d’éléments avec l’étiquette HTML spécifiée.Retrieve a collection of elements with the specified HTML tag.

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

Récupère le code de hachage pour cet objet.Retrieves the hash code for this object.

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

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

(Inherited from Object)
InvokeScript(String) InvokeScript(String) InvokeScript(String) InvokeScript(String)

Exécute une fonction Active Scripting définie dans une page HTML.Executes an Active Scripting function defined in an HTML page.

InvokeScript(String, Object[]) InvokeScript(String, Object[]) InvokeScript(String, Object[]) InvokeScript(String, Object[])

Exécute une fonction Active Scripting définie dans une page HTML.Executes an Active Scripting function defined in an HTML page.

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

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
OpenNew(Boolean) OpenNew(Boolean) OpenNew(Boolean) OpenNew(Boolean)

Obtient un nouveau HtmlDocument à utiliser avec la méthode Write(String).Gets a new HtmlDocument to use with the Write(String) method.

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

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

(Inherited from Object)
Write(String) Write(String) Write(String) Write(String)

Écrit une nouvelle page HTML.Writes a new HTML page.

Événements

Click Click Click Click

Se produit lorsque l'utilisateur clique dans le document.Occurs when the user clicks anywhere on the document.

ContextMenuShowing ContextMenuShowing ContextMenuShowing ContextMenuShowing

Se produit quand l'utilisateur demande d'afficher le menu contextuel du document.Occurs when the user requests to display the document's context menu.

Focusing Focusing Focusing Focusing

Se produit avant que le focus soit donné au document.Occurs before focus is given to the document.

LosingFocus LosingFocus LosingFocus LosingFocus

Se produit quand le focus quitte un contrôle.Occurs while focus is leaving a control.

MouseDown MouseDown MouseDown MouseDown

Se produit lorsque l'utilisateur clique sur le bouton gauche de la souris.Occurs when the user clicks the left mouse button.

MouseLeave MouseLeave MouseLeave MouseLeave

Se produit quand la souris ne survole plus le document.Occurs when the mouse is no longer hovering over the document.

MouseMove MouseMove MouseMove MouseMove

Se produit lorsque la souris est placée au-dessus du document.Occurs when the mouse is moved over the document.

MouseOver MouseOver MouseOver MouseOver

Se produit lorsque la souris est placée au-dessus du document.Occurs when the mouse is moved over the document.

MouseUp MouseUp MouseUp MouseUp

Se produit quand l’utilisateur relâche le bouton gauche de la souris.Occurs when the user releases the left mouse button.

Stop Stop Stop Stop

Se produit quand la navigation vers une autre page web est arrêtée.Occurs when navigation to another Web page is halted.

Opérateurs

Equality(HtmlDocument, HtmlDocument) Equality(HtmlDocument, HtmlDocument) Equality(HtmlDocument, HtmlDocument) Equality(HtmlDocument, HtmlDocument)

Retourne une valeur qui indique si les instances de HtmlDocument spécifiées représentent la même valeur.Returns a value that indicates whether the specified HtmlDocument instances represent the same value.

Inequality(HtmlDocument, HtmlDocument) Inequality(HtmlDocument, HtmlDocument) Inequality(HtmlDocument, HtmlDocument) Inequality(HtmlDocument, HtmlDocument)

Retourne une valeur qui indique si les instances de HtmlDocument spécifiées ne représentent pas la même valeur.Returns a value that indicates whether the specified HtmlDocument instances do not represent the same value.

S’applique à

Voir aussi