HtmlDocument Classe

Definizione

public ref class HtmlDocument sealed

public sealed class HtmlDocument

type HtmlDocument = class

Public NotInheritable Class HtmlDocument

Ereditarietà

Object

HtmlDocument

Esempio

Nell'esempio di codice seguente vengono usati i dati del database Northwind per creare un oggetto HTML TABLE in modo dinamico usando CreateElement. Viene AppendChild inoltre utilizzato il metodo , innanzitutto per aggiungere celle (TD elementi) a righe (TR elementi), quindi per aggiungere righe alla tabella e infine per aggiungere la tabella alla fine del documento corrente. L'esempio di codice richiede che l'applicazione abbia un WebBrowser controllo denominato WebBrowser1. Il codice deve essere chiamato dopo il caricamento di un documento.

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

Commenti

HtmlDocument fornisce un wrapper gestito intorno all'oggetto documento di Internet Explorer, noto anche come DOM (Document Object Model) HTML. Si ottiene un'istanza di HtmlDocument tramite la Document proprietà del WebBrowser controllo .

I tag HTML all'interno di un documento HTML possono essere annidati tra loro. HtmlDocument rappresenta quindi un albero di documenti, i cui figli sono istanze della HtmlElement classe . Nell'esempio di codice seguente viene illustrato un semplice file HTML.

<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 questo esempio rappresenta HtmlDocument l'intero documento all'interno dei HTML tag. I BODYtag , FORMDIVe SPAN sono rappresentati da singoli HtmlElement oggetti.

Esistono diversi modi per accedere agli elementi in questa struttura ad albero. Utilizzare la Body proprietà per accedere al BODY tag e a tutti i relativi elementi figlio. La ActiveElement proprietà fornisce l'oggetto HtmlElement per l'elemento in una pagina HTML con stato attivo l'input dell'utente. Tutti gli elementi all'interno di una pagina HTML possono avere un nome; la raccolta fornisce l'accesso All a ogni HtmlElement oggetto usando il relativo nome come indice. GetElementsByTagName restituirà un oggetto HtmlElementCollection di tutti gli HtmlElement oggetti con un determinato nome di tag HTML, ad esempio DIV o TABLE. GetElementById restituirà il singolo HtmlElement corrispondente all'ID univoco fornito. GetElementFromPoint restituirà l'oggetto HtmlElement che può essere trovato sullo schermo in corrispondenza delle coordinate del puntatore del mouse fornite.

È anche possibile usare la Forms raccolta e Images per scorrere gli elementi che rappresentano rispettivamente moduli di input utente e grafica.

HtmlDocument si basa sulle interfacce non gestite implementate dal DOM DHTML di Internet Explorer: IHTMLDocument, IHTMLDocument2, IHTMLDocument3e IHTMLDocument4. Solo le proprietà e i metodi usati più di frequente in queste interfacce non gestite vengono esposti da HtmlDocument. È possibile accedere a tutte le altre proprietà e metodi direttamente usando la DomDocument proprietà , che è possibile eseguire il cast al puntatore di interfaccia non gestito desiderato.

Un documento HTML può contenere frame, che sono finestre diverse all'interno del WebBrowser controllo. Ogni frame visualizza la propria pagina HTML. L'insieme Frames è disponibile tramite la Window proprietà . È anche possibile utilizzare la Window proprietà per ridimensionare la pagina visualizzata, scorrere il documento o visualizzare avvisi e richieste all'utente.

HtmlDocument espone gli eventi più comuni che ci si aspetta di gestire quando si ospitano pagine HTML. Per gli eventi non esposti direttamente dall'interfaccia, è possibile aggiungere un gestore per l'evento usando AttachEventHandler.

I file HTML possono contenere SCRIPT tag che incapsulano il codice scritto in uno dei linguaggi di scripting attivi, ad esempio JScript o VBScript. Il InvokeScript metodo fornisce l'esecuzione di proprietà e metodi definiti in un SCRIPT tag.

Vedi anche

• document - API Web
• Interfaccia IHTMLDocument2