Общие сведения об элементе управления WebBrowser
Обновлен: Ноябрь 2007
Элемент управления 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-адресу. |
См. также
Задачи
Практическое руководство. Переход по заданному URL с помощью элемента управления WebBrowser
Практическое руководство. Печать с использованием элемента управления WebBrowser
Практическое руководство. Добавление функциональности веб-обозревателя в приложения Windows Forms
Практическое руководство. Создание средства просмотра HTML-документов в приложении Windows Forms
Основные понятия
Безопасность элемента управления WebBrowser
Ссылки
WebBrowserDocumentCompletedEventArgs
WebBrowserDocumentCompletedEventHandler
WebBrowserNavigatedEventHandler
WebBrowserNavigatingEventHandler