Übersicht über das WebBrowser-Steuerelement

  • Artikel

Das WebBrowser-Steuerelement bietet einen verwalteten Wrapper für das WebBrowser-ActiveX-Steuerelement. Mit dem verwalteten Wrapper können Sie Webseiten in Ihren Windows Forms-Clientanwendungen anzeigen. Sie können das WebBrowser-Steuerelement verwenden, um die Webbrowserfunktionalität von Internet Explorer in Ihrer Anwendung zu duplizieren, oder Sie können die Standardfunktionalität von Internet Explorer deaktivieren und das Steuerelement als einfachen HTML-Dokument-Viewer verwenden. Sie können das Steuerelement auch verwenden, um DHTML-basierte Benutzeroberflächenelemente zu Ihrem Formular hinzuzufügen und die Tatsache zu verbergen, dass sie im WebBrowser-Steuerelement gehostet werden. Mit diesem Ansatz können Sie Websteuerelemente problemlos mit Windows Forms-Steuerelementen in einer einzelnen Anwendung kombinieren.

Häufig verwendete Eigenschaften, Methoden und Ereignisse

Das WebBrowser-Steuerelement verfügt über mehrere Eigenschaften, Methoden und Ereignisse, die Sie zur Implementierung von Steuerelementen in Internet Explorer verwenden können. Sie können z. B. die Navigate-Methode verwenden, um eine Adressleiste zu implementieren, und die Methoden GoBack, GoForward, Stop und Refresh, um Navigationsschaltflächen in einer Symbolleiste zu implementieren. Sie können das Navigated-Ereignis behandeln, um die Adressleiste mit dem Wert der Eigenschaft Url und die Titelleiste mit dem Wert der DocumentTitle-Eigenschaft zu aktualisieren.

Wenn Sie Ihren eigenen Seiteninhalt innerhalb Ihrer Anwendung generieren möchten, können Sie die DocumentText-Eigenschaft festlegen. Wenn Sie mit dem HTML-Dokumentobjektmodell (DOM) vertraut sind, können Sie den Inhalt der aktuellen Webseite auch über die Document-Eigenschaft bearbeiten. Mit dieser Eigenschaft können Sie Dokumente im Arbeitsspeicher speichern und ändern, anstatt zwischen Dateien zu navigieren.

Mit der Document-Eigenschaft können Sie auch Methoden, die im Skriptcode von Webseiten implementiert sind, von Ihrem Clientanwendungscode aus aufrufen. Legen Sie die ObjectForScripting-Eigenschaft fest, um auf den Clientanwendungscode über Ihren Skriptcode zuzugreifen. Auf das von Ihnen angegebene Objekt kann Ihr Skriptcode als window.external-Objekt zugreifen.

Name Beschreibung
Document-Eigenschaft Ruft ein Objekt ab, das verwalteten Zugriff auf das HTML-Dokumentobjektmodell (DOM) der aktuellen Webseite bietet.
DocumentCompleted -Ereignis Tritt auf, wenn das Laden einer Webseite abgeschlossen ist.
DocumentText-Eigenschaft Ruft den HTML-Inhalt der aktuellen Webseite ab oder legt ihn fest.
DocumentTitle-Eigenschaft Ruft den Titel der aktuellen Webseite ab.
GoBack-Methode Navigiert zur vorherigen Seite im Verlauf.
GoForward-Methode Navigiert zur nächsten Seite im Verlauf.
Navigate-Methode Navigiert zur angegebenen URL.
Navigating -Ereignis Tritt auf, bevor die Navigation beginnt, damit die Aktion abgebrochen werden kann.
ObjectForScripting-Eigenschaft Ruft ein Objekt ab oder legt es fest, mit dem der Skriptcode der Webseite für die Kommunikation mit Ihrer Anwendung verwendet werden kann.
Print-Methode Druckt die aktuelle Webseite.
Refresh-Methode Lädt die aktuelle Webseite neu.
Stop-Methode Hält die aktuelle Navigation an und beendet dynamische Seitenelemente wie Sounds und Animationen.
Url-Eigenschaft Ruft die URL der aktuellen Webseite ab oder legt diese fest. Durch Festlegen dieser Eigenschaft wird das Steuerelement zur neuen URL navigiert.

Weitere Informationen