HtmlDocument Třída

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Poskytuje programový přístup k dokumentu HTML hostovaným ovládacím WebBrowser prvku na nejvyšší úrovni.

public ref class HtmlDocument sealed

public sealed class HtmlDocument

type HtmlDocument = class

Public NotInheritable Class HtmlDocument

Dědičnost: Object
HtmlDocument

Příklady

Následující příklad kódu používá data z databáze Northwind k vytvoření HTML TABLE dynamicky pomocí CreateElement. Metoda AppendChild se také používá, nejprve přidat buňky (prvky) k řádkům (TD``TRelementy), pak přidat řádky do tabulky a nakonec připojit tabulku na konec aktuálního dokumentu. Příklad kódu vyžaduje, aby vaše aplikace má WebBrowser ovládací prvek s názvem WebBrowser1. Kód by se měl volat po načtení dokumentu.

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

Poznámky

HtmlDocument poskytuje spravovaný obálku kolem objektu dokumentu Aplikace Internet Explorer, který se označuje také jako MODEL OBJEKTU DOKUMENTU HTML (DOM). Získáte instanci HtmlDocument prostřednictvím Document vlastnosti WebBrowser ovládacího prvku.

Značky HTML uvnitř dokumentu HTML je možné vnořit do sebe. HtmlDocument představuje strom dokumentů, jehož podřízené objekty HtmlElement jsou instance třídy. Následující příklad kódu ukazuje jednoduchý soubor 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>

V tomto příkladu HtmlDocument představuje celý dokument uvnitř HTML značek. Značky BODYa , SPAN DIV``FORM jsou reprezentovány jednotlivými HtmlElement objekty.

K prvkům v tomto stromu máte přístup několika způsoby. Body Vlastnost použijte pro přístup BODY ke značce a všem podřízeným položkě. Vlastnost ActiveElement poskytuje HtmlElement prvek na stránce HTML, která má fokus uživatelského vstupu. Všechny prvky na stránce HTML můžou mít název; kolekce All poskytuje přístup ke každému HtmlElement pomocí názvu jako indexu. GetElementsByTagName vrátí HtmlElementCollection všechny HtmlElement objekty s daným názvem značky HTML, například DIV nebo TABLE. GetElementById vrátí jedinou HtmlElement odpovídající jedinečnému ID, které zadáte. GetElementFromPoint vrátí HtmlElement ten, který lze najít na obrazovce na zadaných souřadnicích ukazatele myši.

Můžete také použít Forms a Images kolekci k iteraci prvků, které představují uživatelské vstupní formuláře a grafiku.

HtmlDocumentje založená na nespravovaných rozhraních implementovaných nástrojem DHTML DOM aplikace Internet Explorer: IHTMLDocument, , IHTMLDocument3``IHTMLDocument2a IHTMLDocument4. Na těchto nespravovaných rozhraních jsou vystaveny HtmlDocumentpouze nejčastěji používané vlastnosti a metody . Ke všem ostatním vlastnostem a metodám můžete přistupovat přímo pomocí DomDocument vlastnosti, kterou můžete přetypovat na požadovaný nespravovaný ukazatel rozhraní.

Dokument HTML může obsahovat rámce, což jsou různá okna uvnitř WebBrowser ovládacího prvku. Každý rámec zobrazuje vlastní stránku HTML. Kolekce Frames je k dispozici prostřednictvím Window vlastnosti. Vlastnost můžete použít Window také ke změně velikosti zobrazené stránky, posouvání dokumentu nebo zobrazení upozornění a zobrazení výzev uživateli.

HtmlDocument zveřejňuje nejběžnější události, které byste očekávali při hostování stránek HTML. U událostí, které nejsou vystaveny přímo rozhraním, můžete přidat obslužnou rutinu události pomocí AttachEventHandler.

Soubory HTML mohou obsahovat SCRIPT značky, které zapouzdřují kód napsaný v některém z jazyků active scripting, například JScript nebo VBScript. Metoda InvokeScript poskytuje provádění vlastností a metod definovaných ve SCRIPT značce.

Poznámka

Většina vlastností, metod a událostí HtmlDocument u nich sice uchovává stejné názvy jako u nespravovaného modelu DOM, ale některé se změnily kvůli konzistenci s .NET Framework.

Vlastnosti

ActiveElement	HtmlElement Poskytuje aktuálně fokus vstupu uživatele.
ActiveLinkColor	Získá nebo nastaví Color hypertextový odkaz při kliknutí uživatelem.
All	Získá instanci HtmlElementCollection, která ukládá všechny HtmlElement objekty pro dokument.
BackColor	Získá nebo nastaví barvu pozadí dokumentu HTML.
Body	HtmlElement Získá značku `BODY`.
Cookie	Získá nebo nastaví soubory cookie HTTP přidružené k tomuto dokumentu.
DefaultEncoding	Získá kódování používané ve výchozím nastavení pro aktuální dokument.
Domain	Získá nebo nastaví řetězec popisující doménu tohoto dokumentu pro účely zabezpečení.
DomDocument	Získá nespravovaný ukazatel rozhraní pro tento HtmlDocument.
Encoding	Získá nebo nastaví kódování znaků pro tento dokument.
Focused	Získá hodnotu určující, zda dokument má fokus vstupu uživatele.
ForeColor	Získá nebo nastaví barvu textu dokumentu.
Forms	Získá kolekci všech `<prvků FORM>` v dokumentu.
Images	Získá kolekci všech značek obrázků v dokumentu.
LinkColor	Získá nebo nastaví barvu hypertextových odkazů.
Links	Získá seznam všech hypertextových odkazů v tomto dokumentu HTML.
RightToLeft	Získá nebo nastaví směr textu v aktuálním dokumentu.
Title	Získá nebo nastaví text hodnotu značky `<TITLE>` v aktuálním dokumentu HTML.
Url	Získá adresu URL popisující umístění tohoto dokumentu.
VisitedLinkColor	Získá nebo nastaví barvu odkazů na stránky HTML, které uživatel již navštívil.
Window	Získá přidružené k HtmlWindow tomuto dokumentu.

Metody

AttachEventHandler(String, EventHandler)	Přidá obslužnou rutinu události pro pojmenovanou událost HTML DOM.
CreateElement(String)	Vytvoří nový `HtmlElement` typ zadané značky HTML.
DetachEventHandler(String, EventHandler)	Odebere obslužnou rutinu události z pojmenované události v HTML DOM.
Equals(Object)	Otestuje objekt pro rovnost proti aktuálnímu objektu.
ExecCommand(String, Boolean, Object)	Spustí zadaný příkaz pro dokument.
Focus()	Nastaví fokus uživatelského vstupu na aktuální dokument.
GetElementById(String)	Načte jeden HtmlElement atribut `ID` elementu jako vyhledávací klíč.
GetElementFromPoint(Point)	Načte element HTML umístěný v zadaných souřadnicích klienta.
GetElementsByTagName(String)	Načtěte kolekci prvků se zadanou značkou HTML.
GetHashCode()	Načte kód hash pro tento objekt.
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
InvokeScript(String)	Spustí aktivní skriptovací funkci definovanou na stránce HTML.
InvokeScript(String, Object[])	Spustí aktivní skriptovací funkci definovanou na stránce HTML.
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
OpenNew(Boolean)	Získá nové HtmlDocument použití s metodou Write(String) .
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
Write(String)	Zapíše novou stránku HTML.

Operátory

Equality(HtmlDocument, HtmlDocument)	Vrátí hodnotu, která určuje, jestli zadané HtmlDocument instance představují stejnou hodnotu.
Inequality(HtmlDocument, HtmlDocument)	Vrátí hodnotu, která označuje, zda zadané HtmlDocument instance nepředstavují stejnou hodnotu.

událost

Click	Nastane, když uživatel klikne kamkoli do dokumentu.
ContextMenuShowing	Nastane, když uživatel požádá o zobrazení místní nabídky dokumentu.
Focusing	Nastane před odesláním fokusu do dokumentu.
LosingFocus	Dochází při opuštění ovládacího prvku fokusu.
MouseDown	Nastane, když uživatel klikne na levé tlačítko myši.
MouseLeave	Nastane, když myš už najede myší na dokument.
MouseMove	Nastane, když se myš přesune přes dokument.
MouseOver	Nastane, když se myš přesune přes dokument.
MouseUp	Nastane, když uživatel uvolní levé tlačítko myši.
Stop	Nastane, když se zastaví navigace na jinou webovou stránku.

Platí pro