Vue d'ensemble du contrôle WebBrowser
Mise à jour : novembre 2007
Le contrôle WebBrowser fournit un wrapper managé destiné au contrôle ActiveX WebBrowser. Le wrapper managé permet d'afficher des pages Web dans vos applications clientes Windows Forms. Vous pouvez utiliser le contrôle WebBrowser pour dupliquer les fonctionnalités de navigation Web d'Internet Explorer dans votre application ou encore désactiver les fonctionnalités Internet Explorer par défaut et utiliser ce contrôle comme une simple visionneuse de documents HTML. Vous pouvez également utiliser le contrôle pour ajouter des éléments d'interface utilisateur DHTML à votre formulaire et masquer le fait qu'ils sont hébergés dans le contrôle WebBrowser. Cette approche vous permet de combiner de façon transparente les contrôles Web et Windows Forms dans une même application.
Propriétés, méthodes et événements fréquemment utilisés
Le contrôle WebBrowser possède plusieurs propriétés, méthodes et événements que vous pouvez utiliser pour implémenter des contrôles d'Internet Explorer. Par exemple, vous pouvez utiliser la méthode Navigate pour implémenter une barre d'adresses, et les méthodes GoBack, GoForward, Stop et Refresh pour implémenter des boutons de navigation sur une barre d'outils. Vous pouvez gérer l'événement Navigated pour mettre à jour la barre d'adresses avec la valeur de la propriété Url et la barre de titre avec la valeur de la propriété DocumentTitle.
Si vous souhaitez générer votre propre contenu de page dans votre application, vous pouvez définir la propriété DocumentText. Si vous connaissez le modèle DOM (Document Object Model) HTML, vous pouvez également manipuler le contenu de la page Web en cours via la propriété Document. À l'aide de cette propriété, vous pouvez stocker et modifier des documents dans la mémoire au lieu d'explorer les fichiers.
La propriété Document vous permet également d'appeler des méthodes implémentées dans du code de script de page Web à partir de votre code d'application cliente. Pour accéder au code d'application cliente à partir du code de script, définissez la propriété ObjectForScripting. L'objet spécifié est accessible par votre code de script en tant qu'objet window.external.
Nom |
Description |
|---|---|
Propriété Document |
Obtient un objet qui fournit un accès managé au modèle DOM (Document Object Model) HTML de la page Web en cours. |
Événement DocumentCompleted |
Se produit à la fin du chargement d'une page Web. |
Propriété DocumentText |
Obtient ou définit le contenu HTML de la page Web en cours. |
Propriété DocumentTitle |
Obtient le titre de la page Web en cours. |
Méthode GoBack |
Accède à la page précédente de l'historique. |
Méthode GoForward |
Accède à la page suivante de l'historique. |
Méthode Navigate |
Accède à l'URL spécifiée. |
Événement Navigating |
Se produit avant le début de la navigation et permet d'annuler l'action. |
Propriété ObjectForScripting |
Obtient ou définit un objet que le code de script de la page Web peut utiliser pour communiquer avec votre application. |
Méthode Print |
Imprime la page Web en cours. |
Méthode Refresh |
Recharge la page Web en cours. |
Méthode Stop |
Arrête la navigation en cours, ainsi que les éléments de page dynamiques, tels que les sons et animations. |
Propriété Url |
Obtient ou définit l'URL de la page Web en cours. La définition de cette propriété permet au contrôle d'accéder à la nouvelle URL. |
Voir aussi
Tâches
Comment : naviguer vers une URL avec un contrôle WebBrowser
Comment : imprimer avec un contrôle WebBrowser
Comment : ajouter des fonctionnalités de navigateur Web à une application Windows Forms
Comment : créer une visionneuse de documents HTML dans une application Windows Forms
Concepts
Référence
WebBrowserDocumentCompletedEventArgs
WebBrowserDocumentCompletedEventHandler
WebBrowserNavigatedEventHandler
WebBrowserNavigatingEventHandler