Übersicht über das WebBrowser-Steuerelement
Aktualisiert: November 2007
Das WebBrowser-Steuerelement stellt einen verwalteten Wrapper für das WebBrowser-ActiveX-Steuerelement bereit. Mit dem verwalteten Wrapper können Sie Webseiten in Windows Forms-Clientanwendungen anzeigen. Mit dem WebBrowser-Steuerelement können Sie die Webbrowserfunktionalität von Internet Explorer in der Anwendung duplizieren oder die Standardfunktionalität von Internet Explorer deaktivieren und das Steuerelement als einfachen HTML-Dokument-Viewer verwenden. Mit diesem Steuerelement können Sie außerdem einem Formular DHTML-basierte Benutzerschnittstellenelemente hinzufügen und negieren, dass sie im WebBrowser-Steuerelement integriert sind. Diese Vorgehensweise ermöglicht die reibungslose Kombination von Websteuerelementen und Windows Forms-Steuerelementen in einer Anwendung.
Häufig verwendete Eigenschaften, Methoden und Ereignisse
Das WebBrowser-Steuerelement verfügt über verschiedene Eigenschaften, Methoden und Ereignisse für die Implementierung von Internet Explorer-Steuerelementen. So können Sie z. B. mit der Navigate-Methode eine Adressleiste implementieren, und mit den Methoden GoBack, GoForward, Stop und Refresh können Sie Navigationsschaltflächen in einer Symbolleiste implementieren. Durch Behandlung des Navigated-Ereignisses können Sie die Adressleiste mit dem Wert der Url-Eigenschaft und die Titelleiste mit dem Wert der DocumentTitle-Eigenschaft aktualisieren.
Wenn Sie in der Anwendung einen eigenen Seiteninhalt erstellen möchten, können Sie die DocumentText-Eigenschaft festlegen. Falls Sie mit dem HTML-Dokumentenobjektmodell (DOM) vertraut sind, können Sie den Inhalt der aktuellen Webseite auch mit der Document-Eigenschaft bearbeiten. Mit dieser Eigenschaft können Sie Dokumente im Speicher ablegen und bearbeiten, anstatt zwischen Dateien zu navigieren.
Mit der Document-Eigenschaft können Sie auch im Webseitenskriptcode implementierte Methoden von Ihrem Clientanwendungscode aus aufrufen. Um mithilfe des Skriptcodes auf den Clientanwendungscode zuzugreifen, legen Sie die ObjectForScripting-Eigenschaft fest. Der Skriptcode kann auf das angegebene Objekt als window.external-Objekt zugreifen.
Name |
Beschreibung |
|---|---|
Document-Eigenschaft |
Ruft ein Objekt ab, das einen verwalteten Zugriff auf das HTML-Dokumentenobjektmodell (DOM) der aktuellen Webseite ermöglicht. |
DocumentCompleted-Ereignis |
Tritt auf, wenn eine Webseite vollständig geladen ist. |
DocumentText-Eigenschaft |
Ruft den HTML-Inhalt der aktuellen Webseite ab bzw. legt ihn fest. |
DocumentTitle-Eigenschaft |
Ruft den Titel der aktuellen Webseite ab. |
GoBack-Methode |
Navigiert im Navigationsverlauf zur vorherigen Seite. |
GoForward-Methode |
Navigiert im Navigationsverlauf zur nächsten Seite. |
Navigate-Methode |
Navigiert zum angegebenen URL. |
Navigating-Ereignis |
Tritt vor dem Beginn der Navigation auf und ermöglicht den Abbruch der Aktion. |
ObjectForScripting-Eigenschaft |
Ruft ein Objekt ab bzw. legt es fest, das vom Webseitenskriptcode für die Kommunikation mit der Anwendung verwendet werden kann. |
Print-Methode |
Druckt die aktuelle Webseite. |
Refresh-Methode |
Lädt die aktuelle Webseite erneut. |
Stop-Methode |
Hält die aktuelle Navigation an und beendet dynamische Seitenelemente wie Sound und Animation. |
Url-Eigenschaft |
Ruft den URL der aktuellen Webseite ab bzw. legt ihn fest. Mit der Festlegung dieser Eigenschaft wird das Steuerelement zum neuen URL navigiert. |
Siehe auch
Aufgaben
Gewusst wie: Navigieren zu einem URL mit dem WebBrowser-Steuerelement
Gewusst wie: Drucken mit einem WebBrowser-Steuerelement
Gewusst wie: Hinzufügen von Webbrowserfunktionen zu einer Windows Forms-Anwendung
Gewusst wie: Erstellen eines HTML-Dokumentviewers in einer Windows Forms-Anwendung
Konzepte
Referenz
WebBrowserDocumentCompletedEventArgs
WebBrowserDocumentCompletedEventHandler
WebBrowserNavigatedEventHandler
WebBrowserNavigatingEventHandler