Procedure: Toegang krijgen tot het beheerde HTML-documentobjectmodel

U kunt het beheerde HTML Document Object Model (DOM) openen vanuit twee typen toepassingen:

• Een Windows Forms-toepassing (.exe) die als host fungeert voor het beheerde WebBrowser besturingselement. Deze twee technologieën vormen een aanvulling op elkaar, waarbij het besturingselement WebBrowser de pagina weergeeft aan de gebruiker en de HTML DOM die de logische structuur van het document vertegenwoordigt.

• Een Windows Forms-UserControl gehost in Internet Explorer. U kunt de HTML-DOM openen die de pagina vertegenwoordigt waarop uw UserControl wordt gehost om de structuur van het document te wijzigen of modale dialoogvensters te openen, onder andere vele andere mogelijkheden.

Toegang krijgen tot DOM vanuit een Windows Forms-toepassing

1. Host een WebBrowser besturingselement in uw Windows Forms-toepassing en monitor de DocumentCompleted gebeurtenis. Zie Evenementenvoor meer informatie over de beheersing en monitoring van evenementen.

2. Haal de HtmlDocument voor de huidige pagina op door toegang te krijgen tot de eigenschap Document van het besturingselement WebBrowser.

Toegang krijgen tot DOM vanuit een UserControl die wordt gehost in Internet Explorer

1. Maak uw eigen aangepaste afgeleide klasse van de UserControl-klasse. Voor meer informatie, zie Hoe te: Samengestelde besturingselementen maken.

2. Plaats de volgende code in uw Load-gebeurtenishandler voor uw UserControl:

HtmlDocument doc = null;

private void UserControl1_Load(object sender, EventArgs e)
{
    if (this.Site != null)
    {
        doc = (HtmlDocument)this.Site.GetService(typeof(HtmlDocument));
    }
}

Private Sub UserControl1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
    If (Me.Site IsNot Nothing) Then
        Dim Doc As HtmlDocument = CType(Me.Site.GetService(Type.GetType("System.Windows.Forms.HtmlDocument")), HtmlDocument)
    End If
End Sub

Robuuste programmering

1. Wanneer u de DOM via het besturingselement WebBrowser gebruikt, moet u altijd wachten totdat de gebeurtenis DocumentCompleted plaatsvindt voordat u toegang probeert te krijgen tot de eigenschap Document van het besturingselement WebBrowser. De gebeurtenis DocumentCompleted wordt gegenereerd nadat het hele document is geladen; als u de DOM eerder gebruikt, riskeert u een runtime-uitzondering in uw toepassing.

.NET Framework-beveiliging

1. Voor uw toepassing of UserControl is volledig vertrouwen vereist om toegang te krijgen tot de beheerde HTML DOM. Als u een Windows Forms-toepassing implementeert met ClickOnce, kunt u volledige vertrouwensrelatie aanvragen met behulp van machtigingsverhoging of implementatie van vertrouwde toepassingen; zie ClickOnce-toepassingen beveiligen voor meer informatie.

Zie ook

• het beheerde HTML-documentobjectmodel gebruiken