Общие сведения об элементе управления 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-адресу.

См. также