Partager via

Guide pratique pour accéder au modèle objet document HTML managé

Vous pouvez accéder au modèle DOM (Document Object Model) HTML managé à partir de deux types d’applications :

  • Application Windows Forms (.exe) qui hébergeait le contrôle managé WebBrowser. Ces deux technologies se complètent les unes les autres, avec le WebBrowser contrôle affichant la page à l’utilisateur et le DOM HTML représentant la structure logique du document.

  • Windows Forms UserControl hébergé dans Internet Explorer. Vous pouvez accéder au DOM HTML représentant la page sur laquelle vous UserControl êtes hébergé pour modifier la structure du document ou ouvrir des boîtes de dialogue modales, entre autres possibilités.

Pour accéder au DOM à partir d’une application Windows Forms

  1. Hébergez un WebBrowser contrôle dans votre application Windows Forms et surveillez l’événement DocumentCompleted . Pour plus d’informations sur l’hébergement des contrôles et la surveillance des événements, consultez Événements.

  2. Récupérez la HtmlDocument pour la page actuelle en accédant à la propriété Document du contrôle WebBrowser.

Pour accéder au DOM à partir d’un UserControl hébergé dans Internet Explorer

  1. Créez votre propre classe dérivée personnalisée de la UserControl classe. Pour plus d’informations, consultez Guide pratique pour créer des contrôles composites.

  2. Placez le code suivant à l’intérieur de votre gestionnaire d’événements Load pour votre 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

Programmation robuste

  1. Lorsque vous utilisez le DOM via le WebBrowser contrôle, vous devez toujours attendre que l’événement DocumentCompleted se produise avant de tenter d’accéder à la Document propriété du WebBrowser contrôle. L’événement DocumentCompleted est déclenché après le chargement de l’intégralité du document . Si vous utilisez le DOM avant cela, vous risquez d’entraîner une exception d’exécution dans votre application.

Sécurité du .NET Framework

  1. Votre application ou UserControl nécessite une confiance totale pour accéder au DOM HTML managé. Si vous déployez une application Windows Forms à l’aide de ClickOnce, vous pouvez demander une confiance totale à l’aide de l’élévation d’autorisations ou du déploiement d’applications approuvées ; pour plus d’informations, consultez Sécurisation des applications ClickOnce .

Voir aussi