HtmlDocument Klasse

Definition

public ref class HtmlDocument sealed

public sealed class HtmlDocument

type HtmlDocument = class

Public NotInheritable Class HtmlDocument

Vererbung

Object

HtmlDocument

Beispiele

Im folgenden Codebeispiel werden Daten aus der Northwind-Datenbank verwendet, um dynamisch mithilfe CreateElementvon HTML TABLE zu erstellen. Die AppendChild -Methode wird auch verwendet, um zuerst Zellen (TD Elemente) zu Zeilen (TR -Elemente) hinzuzufügen, dann zeilen zur Tabelle hinzuzufügen und schließlich, um die Tabelle am Ende des aktuellen Dokuments anzufügen. Das Codebeispiel erfordert, dass Ihre Anwendung über ein WebBrowser Steuerelement mit dem Namen verfügt WebBrowser1. Der Code sollte aufgerufen werden, nachdem ein Dokument geladen wurde.

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

Hinweise

HtmlDocument stellt einen verwalteten Wrapper um das Dokumentobjekt von Internet Explorer bereit, das auch als HTML-Dokumentobjektmodell (DOM) bezeichnet wird. Sie erhalten eine Instanz von HtmlDocument über die Document -Eigenschaft des -Steuerelements WebBrowser .

HTML-Tags innerhalb eines HTML-Dokuments können ineinander geschachtelt werden. HtmlDocument stellt somit eine Dokumentstruktur dar, deren untergeordnete Elemente Instanzen der HtmlElement -Klasse sind. Das folgende Codebeispiel zeigt eine einfache HTML-Datei.

<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 diesem Beispiel HtmlDocument stellt das gesamte Dokument in den HTML Tags dar. Die BODYTags , DIVund SPANFORM werden durch einzelne HtmlElement Objekte dargestellt.

Es gibt mehrere Möglichkeiten, wie Sie auf die Elemente in dieser Struktur zugreifen können. Verwenden Sie die Body -Eigenschaft, um auf das BODY Tag und alle untergeordneten Elemente zuzugreifen. Die ActiveElement -Eigenschaft gibt Ihnen die HtmlElement für das -Element auf einer HTML-Seite an, die den Benutzereingabefokus hat. Alle Elemente innerhalb einer HTML-Seite können einen Namen haben. Die All -Auflistung ermöglicht den Zugriff auf jedes HtmlElement Objekt mithilfe ihres Namens als Index. GetElementsByTagName gibt eine HtmlElementCollection von allen HtmlElement -Objekten mit einem angegebenen HTML-Tagnamen zurück, z DIV . B. oder TABLE. GetElementById gibt die einzelne HtmlElement zurück, die der von Ihnen angegebenen eindeutigen ID entspricht. GetElementFromPoint gibt den zurück, der HtmlElement auf dem Bildschirm an den angegebenen Mauszeigerkoordinaten zu finden ist.

Sie können auch die Forms - und Images -Auflistung verwenden, um Elemente zu durchlaufen, die Benutzereingabeformulare bzw. -grafiken darstellen.

HtmlDocument basiert auf den nicht verwalteten Schnittstellen, die vom DHTML-DOM von Internet Explorer implementiert werden: IHTMLDocument, IHTMLDocument2, IHTMLDocument3und IHTMLDocument4. Nur die am häufigsten verwendeten Eigenschaften und Methoden für diese nicht verwalteten Schnittstellen werden von HtmlDocumentverfügbar gemacht. Sie können direkt mit der DomDocument -Eigenschaft auf alle anderen Eigenschaften und Methoden zugreifen, die Sie in den gewünschten nicht verwalteten Schnittstellenzeiger umwandeln können.

Ein HTML-Dokument kann Frames enthalten, bei denen es sich um unterschiedliche Fenster innerhalb des WebBrowser Steuerelements handelt. Jeder Frame zeigt eine eigene HTML-Seite an. Die Frames Auflistung ist über die Window -Eigenschaft verfügbar. Sie können die -Eigenschaft auch verwenden, um die Window Größe der angezeigten Seite zu ändern, im Dokument zu scrollen oder Warnungen und Eingabeaufforderungen für den Benutzer anzuzeigen.

HtmlDocument macht die häufigsten Ereignisse verfügbar, die sie beim Hosten von HTML-Seiten behandeln würden. Für Ereignisse, die nicht direkt von der Schnittstelle verfügbar gemacht werden, können Sie mithilfe AttachEventHandlervon einen Handler für das -Ereignis hinzufügen.

HTML-Dateien können Tags enthalten SCRIPT , die Code kapseln, der in einer der Active Scripting-Sprachen wie JScript oder VBScript geschrieben wurde. Die InvokeScript -Methode ermöglicht die Ausführung von Eigenschaften und Methoden, die in einem SCRIPT Tag definiert sind.

Eigenschaften

Methoden

Operatoren

Ereignisse

Gilt für:

Weitere Informationen

• document – Web-APIs
• IHTMLDocument2-Schnittstelle