Обзор элемента управления WebBrowser

Элемент управления WebBrowser обеспечивает управляемую оболочку для элемента управления ActiveX WebBrowser. Управляемая оболочка позволяет отображать веб-страницы в клиентских приложениях Windows Forms. Вы можете использовать элемент управления WebBrowser для дублирования функций браузера Internet Explorer в приложении или отключения функций Internet Explorer по умолчанию и использования элемента управления в качестве простого средства просмотра HTML-документов. Вы также можете использовать элемент управления для добавления элементов пользовательского интерфейса на основе DHTML в форму и скрыть тот факт, что они размещены в элементе управления WebBrowser. Такой подход позволяет легко объединять веб-элементы управления с элементами управления Windows Forms в одном приложении.

Часто используемые свойства, методы и события

Элемент управления WebBrowser содержит несколько свойств, методов и событий, которые можно использовать для реализации элементов управления, найденных в Internet Explorer. Например, можно использовать метод Navigate для реализации адресной строки и методов GoBack, GoForward, Stopи Refresh для реализации кнопок навигации на панели инструментов. Можно обработать событие Navigated, чтобы обновить адресную строку со значением свойства Url и строкой заголовка со значением свойства DocumentTitle.

Если вы хотите создать собственное содержимое страницы в приложении, можно задать свойство DocumentText. Если вы знакомы с объектной моделью HTML-документа (DOM), вы также можете управлять содержимым текущей веб-страницы с помощью свойства Document. С помощью этого свойства можно хранить и изменять документы в памяти, а не перемещаться между файлами.

Свойство Document также позволяет вызывать методы, реализованные в коде скриптов веб-страниц из клиентского кода приложения. Чтобы получить доступ к коду клиентского приложения из кода скриптов, задайте свойство ObjectForScripting. Указанный объект можно получить с помощью кода скрипта в качестве объекта window.external.

Имя Описание
Свойство Document Возвращает объект, предоставляющий управляемый доступ к объектной модели HTML-документа (DOM) текущей веб-страницы.
событие DocumentCompleted Происходит при завершении загрузки веб-страницы.
Свойство DocumentText Возвращает или задает HTML-содержимое текущей веб-страницы.
Свойство DocumentTitle Возвращает заголовок текущей веб-страницы.
GoBackМетод Переходит на предыдущую страницу в журнале.
GoForwardМетод Переходит на следующую страницу в истории.
NavigateМетод Переходит к указанному URL-адресу.
событие Navigating Происходит перед началом навигации, что позволяет отменить действие.
Свойство ObjectForScripting Возвращает или задает объект, который код скриптов веб-страниц может использовать для взаимодействия с приложением.
PrintМетод Печатает текущую веб-страницу.
RefreshМетод Перезагрузит текущую веб-страницу.
StopМетод Останавливает текущую навигацию и останавливает динамические элементы страницы, такие как звуки и анимация.
Свойство Url Возвращает или задает URL-адрес текущей веб-страницы. При задании этого свойства элемент управления переходит к новому URL-адресу.

См. также