HtmlDocument Klas

Definitie

public ref class HtmlDocument sealed

public sealed class HtmlDocument

type HtmlDocument = class

Public NotInheritable Class HtmlDocument

Overname

Object

HtmlDocument

Voorbeelden

In het volgende codevoorbeeld worden gegevens uit de Northwind-database gebruikt om een HTML TABLE dynamisch te maken met behulp van CreateElement. De AppendChild methode wordt ook gebruikt, eerst om cellen (TD elementen) toe te voegen aan rijen (TR elementen), vervolgens rijen aan de tabel toe te voegen en ten slotte de tabel toe te voegen aan het einde van het huidige document. Het codevoorbeeld vereist dat uw toepassing een besturingselement met de WebBrowser naam WebBrowser1heeft. De code moet worden aangeroepen nadat een document is geladen.

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

Opmerkingen

HtmlDocument biedt een beheerde wrapper rond het documentobject van Internet Explorer, ook wel bekend als het HTML Document Object Model (DOM). U verkrijgt een exemplaar van HtmlDocument via de Document eigenschap van het WebBrowser besturingselement.

HTML-tags in een HTML-document kunnen in elkaar worden genest. HtmlDocument vertegenwoordigt dus een documentstructuur, waarvan de onderliggende exemplaren van de HtmlElement klasse zijn. In het volgende codevoorbeeld ziet u een eenvoudig HTML-bestand.

<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>

In dit voorbeeld HtmlDocument vertegenwoordigt u het hele document in de HTML tags. De BODY, DIVFORM en SPAN tags worden vertegenwoordigd door afzonderlijke HtmlElement objecten.

Er zijn verschillende manieren waarop u toegang hebt tot de elementen in deze structuur. Gebruik de Body eigenschap om toegang te krijgen tot de BODY tag en alle onderliggende items. De ActiveElement eigenschap geeft u het HtmlElement voor het element op een HTML-pagina met de focus op gebruikersinvoer. Alle elementen in een HTML-pagina kunnen een naam hebben; de All verzameling biedt toegang tot elk HtmlElement met behulp van de naam als een index. GetElementsByTagName retourneert een HtmlElementCollection van alle HtmlElement objecten met een bepaalde HTML-tagnaam, zoals DIV of TABLE. GetElementById retourneert de enige HtmlElement die overeenkomt met de unieke id die u opgeeft. GetElementFromPoint retourneert de HtmlElement die u op het scherm kunt vinden op de opgegeven coördinaten van de muis aanwijzer.

U kunt de Forms en Images verzameling ook gebruiken om te herhalen door elementen die respectievelijk gebruikersinvoerformulieren en afbeeldingen vertegenwoordigen.

HtmlDocument is gebaseerd op de niet-beheerde interfaces die zijn geïmplementeerd door DHTML DOM van Internet Explorer: IHTMLDocument, IHTMLDocument2, IHTMLDocument3 en IHTMLDocument4. Alleen de meest gebruikte eigenschappen en methoden op deze onbeheerde interfaces worden weergegeven door HtmlDocument. U kunt alle andere eigenschappen en methoden rechtstreeks openen met behulp van de DomDocument eigenschap, die u kunt casten naar de gewenste onbeheerde interfacepointer.

Een HTML-document kan frames bevatten, die verschillende vensters in het WebBrowser besturingselement zijn. Elk frame geeft een eigen HTML-pagina weer. De Frames verzameling is beschikbaar via de Window eigenschap. U kunt de eigenschap ook gebruiken om het Window formaat van de weergegeven pagina te wijzigen, door het document te schuiven of waarschuwingen en aanwijzingen voor de gebruiker weer te geven.

HtmlDocument toont de meest voorkomende gebeurtenissen die u verwacht te verwerken bij het hosten van HTML-pagina's. Voor gebeurtenissen die niet rechtstreeks door de interface worden weergegeven, kunt u een handler voor de gebeurtenis toevoegen met behulp van AttachEventHandler.

HTML-bestanden kunnen tags bevatten SCRIPT die code inkapselen die zijn geschreven in een van de actieve scripttalen, zoals JScript of VBScript. De InvokeScript methode biedt de uitvoering van eigenschappen en methoden die zijn gedefinieerd in een SCRIPT tag.

Zie ook

• document - Web-API's
• IHTMLDocument2 Interface