Добавление возможностей веб-браузера в приложение Windows Forms How to add web browser capabilities to a Windows Forms application

Элемент управления WebBrowser позволяет добавить в приложение функциональность веб-браузера. With the WebBrowser control, you can add Web browser functionality to your application. По умолчанию он работает как веб-браузер. The control works like a Web browser by default. После загрузки начального URL-адреса путем установки свойства Url можно переходить по гиперссылкам, а также совершать переход вперед и назад по истории навигации с помощью сочетаний клавиш. After you load an initial URL by setting the Url property, you can navigate by clicking hyperlinks or by using keyboard shortcuts to move backward and forward through navigation history. Дополнительные функциональные возможности браузера по умолчанию доступны в контекстном меню, появляющемся при щелчке правой кнопки мыши. By default, you can access additional browser functionality through the right-click shortcut menu. Вы также можете открывать новые документы, сбрасывая их в элемент управления. You can also open new documents by dropping them onto the control. Кроме того, элемент управления WebBrowser имеет несколько свойств, методов и событий, которые можно использовать для реализации возможностей пользовательского интерфейса, аналогичных имеющимся в Internet Explorer. The WebBrowser control also has several properties, methods, and events that you can use to implement user interface features similar to those found in Internet Explorer.

В примере кода ниже реализуются адресная строка, стандартные кнопки браузера, меню Файл, строка состояния и строка заголовка, в которой содержится заголовок текущей страницы. The following code example implements an address bar, typical browser buttons, a File menu, a status bar, and a title bar that displays the current page title.

Пример Example

Компиляция кода Compile the code

Для этого примера требуются: This example requires:

Общие сведения об элементе управления WebBrowser WebBrowser Control Overview

WebBrowserЭлемент управления предоставляет управляемую оболочку для элемента управления ActiveX WebBrowser. The WebBrowser control provides a managed wrapper for the WebBrowser ActiveX control. Управляемая оболочка позволяет отображать веб-страницы в клиентских приложениях Windows Forms. The managed wrapper lets you display Web pages in your Windows Forms client applications. Элемент управления можно использовать WebBrowser для дублирования функций веб-обзора Internet Explorer в приложении или отключения функций Internet Explorer по умолчанию и использования элемента управления в качестве простого средства просмотра HTML-документов. You can use the WebBrowser control to duplicate Internet Explorer Web browsing functionality in your application or you can disable default Internet Explorer functionality and use the control as a simple HTML document viewer. Кроме того, элемент управления можно использовать для добавления в форму элементов пользовательского интерфейса на основе DHTML и скрытия того факта, что они размещаются в WebBrowser элементе управления. You can also use the control to add DHTML-based user interface elements to your form and hide the fact that they are hosted in the WebBrowser control. Такой подход позволяет легко объединять веб-элементы управления с Windows Forms элементами управления в одном приложении. This approach lets you seamlessly combine Web controls with Windows Forms controls in a single application.

Часто используемые свойства, методы и события Frequently Used Properties, Methods, and Events

WebBrowserЭлемент управления имеет несколько свойств, методов и событий, которые можно использовать для реализации элементов управления, найденных в Internet Explorer. The WebBrowser control has several properties, methods, and events that you can use to implement controls found in Internet Explorer. Например, можно использовать Navigate метод для реализации адресной строки, а также методы,, GoBack GoForward Stop и Refresh для реализации кнопок навигации на панели инструментов. For example, you can use the Navigate method to implement an address bar, and the GoBack , GoForward , Stop , and Refresh methods to implement navigation buttons on a toolbar. Можно Navigated выполнить обработку события, чтобы обновить адресную строку со значением свойства и заголовком Url со значением DocumentTitle Свойства. You can handle the Navigated event to update the address bar with the value of the Url property and the title bar with the value of the DocumentTitle property.

Если вы хотите создать собственное содержимое страницы в приложении, можно задать DocumentText свойство. If you want to generate your own page content within your application, you can set the DocumentText property. Если вы знакомы с моделью DOM HTML, можно также управлять содержимым текущей веб-страницы с помощью Document Свойства. If you are familiar with the HTML document object model (DOM), you can also manipulate the contents of the current Web page through the Document property. С помощью этого свойства можно хранить и изменять документы в памяти, а не перемещаться между файлами. With this property, you can store and modify documents in memory instead of navigating among files.

Web Browser. Document Свойство

Определение

Получает объект HtmlDocument, представляющий веб-страницу, отображаемую в текущий момент в элементе управления WebBrowser. Gets an HtmlDocument representing the Web page currently displayed in the WebBrowser control.

Значение свойства

Объект HtmlDocument, представляющий текущую страницу, или значение null , если страница не загружается. An HtmlDocument representing the current page, or null if no page is loaded.

Исключения

Данный экземпляр WebBrowser больше не действителен. This WebBrowser instance is no longer valid.

Не удается получить ссылку на реализацию интерфейса IWebBrowser2 из базового элемента управления ActiveX WebBrowser . A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

Примеры

В следующем примере кода показано, как использовать Document свойство в обработчике для события, Navigating чтобы определить, заполнена ли форма веб-страницы. The following code example demonstrates how to use the Document property in a handler for the Navigating event to determine whether a Web page form has been filled in. Если поле ввода не содержит значение, переход отменяется. If the input field does not contain a value, the navigation is canceled.

В этом примере требуется, чтобы форма содержала WebBrowser элемент управления с именем webBrowser1 . This example requires that your form contains a WebBrowser control called webBrowser1 .

Комментарии

Это свойство используется, если требуется получить доступ к содержимому веб-страницы, отображаемой в WebBrowser элементе управления, с помощью модели DOM HTML. Use this property when you want to access the contents of a Web page displayed in the WebBrowser control through the HTML document object model (DOM). Это полезно, например, если вы хотите использовать веб-элементы управления в приложении Windows Forms. This is useful, for example, when you want to use Web-based controls in your Windows Forms application.

Это свойство в сочетании со ObjectForScripting свойством можно использовать для реализации двустороннего взаимодействия между веб-страницей, отображаемой в WebBrowser элементе управления и приложением. You can use this property, in combination with the ObjectForScripting property, to implement two-way communication between a Web page displayed in the WebBrowser control and your application. Используйте HtmlDocument.InvokeScript метод для вызова методов скрипта, реализованных на веб-странице, из кода клиентского приложения. Use the HtmlDocument.InvokeScript method to call script methods implemented in a Web page from your client application code. Код скрипта может получать доступ к приложению через window.external объект, который является встроенным объектом DOM, предоставляемым для доступа к узлу и который соответствует объекту, указанному для ObjectForScripting Свойства. Your scripting code can access your application through the window.external object, which is a built-in DOM object provided for host access, and which maps to an object that you specify for the ObjectForScripting property.

Чтобы получить доступ к содержимому веб-страницы в виде строки, используйте DocumentText свойство. To access the contents of a Web page as a string, use the DocumentText property. Чтобы получить доступ к содержимому веб-страницы в виде Stream , используйте DocumentStream свойство. To access the contents of a Web page as a Stream, use the DocumentStream property.

Web Browser. Go Home Метод

Определение

Перемещает элемент управления WebBrowser на домашнюю страницу текущего пользователя. Navigates the WebBrowser control to the home page of the current user.

Исключения

Данный экземпляр WebBrowser больше не действителен. This WebBrowser instance is no longer valid.

Не удается получить ссылку на реализацию интерфейса IWebBrowser2 из базового элемента управления ActiveX WebBrowser . A reference to an implementation of the IWebBrowser2 interface could not be retrieved from the underlying ActiveX WebBrowser control.

Примеры

В следующем примере кода показано, как использовать GoHome метод для реализации кнопки Home для WebBrowser элемента управления, аналогичного элементу в Internet Explorer. The following code example demonstrates how to use the GoHome method to implement a Home button for the WebBrowser control similar to the one in Internet Explorer. В этом примере требуется, чтобы форма содержала WebBrowser элемент управления webBrowser1 и Button вызывался элемент управления ButtonHome . This example requires that your form contains a WebBrowser control called webBrowser1 and a Button control called ButtonHome .

Комментарии

Этот метод можно использовать для реализации кнопки Home , аналогичной той, которая имеется в Internet Explorer. You can use this method to implement a Home button similar to the one in Internet Explorer. Пользователь может указать домашнюю страницу в диалоговом окне Свойства обозревателя , доступном из панели управления или меню Сервис в Internet Explorer. The user can specify a home page in the Internet Options dialog box, which is available from Control Panel or from the Tools menu in Internet Explorer.

Web Browser. Navigating Событие

Определение

Происходит перед переходом элемента управления WebBrowser в новый документ. Occurs before the WebBrowser control navigates to a new document.

Тип события

Примеры

В следующем примере кода показано, как с помощью обработчика Navigating события отменить навигацию, если форма веб-страницы не заполнена. The following code example demonstrates how to use a handler for the Navigating event to cancel navigation when a Web page form has not been filled in. DocumentСвойство используется для определения того, содержит ли поле ввода значение. The Document property is used to determine whether the form input field contains a value.

В этом примере требуется, чтобы форма содержала WebBrowser элемент управления, webBrowser1 а класс формы стал ComVisibleAttribute доступным для com. This example requires that your form contains a WebBrowser control called webBrowser1 and that your form class has a ComVisibleAttribute making it accessible to COM.

Полный пример кода, в который можно вставить следующий код, см. в разделе как добавить возможности веб-браузера в Windows Forms приложение. For a complete code example that you can paste the following code into, see How to: Add Web Browser Capabilities to a Windows Forms Application.

Комментарии

WebBrowserЭлемент управления переходит к новому документу каждый раз, когда задано одно из следующих свойств или вызывается метод: The WebBrowser control navigates to a new document whenever one of the following properties is set or methods is called:

NavigatingСобытие можно обменять, чтобы отменить навигацию, если не выполнены определенные условия, например когда пользователь не заполнил форму. You can handle the Navigating event to cancel navigation if certain conditions have not been met, for example, when the user has not completely filled out a form. Чтобы отменить навигацию, установите Cancel свойство объекта, WebBrowserNavigatingEventArgs передаваемое обработчику событий, в значение true . To cancel navigation, set the Cancel property of the WebBrowserNavigatingEventArgs object passed to the event handler to true . Этот объект также можно использовать для получения URL-адреса нового документа через WebBrowserNavigatingEventArgs.Url свойство. You can also use this object to retrieve the URL of the new document through the WebBrowserNavigatingEventArgs.Url property. Если новый документ будет отображаться в кадре веб-страницы, можно получить имя рамки через WebBrowserNavigatingEventArgs.TargetFrameName свойство. If the new document will be displayed in a Web page frame, you can retrieve the name of the frame through the WebBrowserNavigatingEventArgs.TargetFrameName property.

Обрабатывает Navigated событие, чтобы получить уведомление, когда WebBrowser элемент управления завершает навигацию и начал загрузку документа в новом расположении. Handle the Navigated event to receive notification when the WebBrowser control finishes navigation and has begun loading the document at the new location. Обрабатывает DocumentCompleted событие, чтобы получить уведомление, когда WebBrowser элемент управления закончит загрузку нового документа. Handle the DocumentCompleted event to receive notification when the WebBrowser control finishes loading the new document.

Дополнительные сведения об обработке событий см. в разделе обработка и вызов событий. For more information about handling events, see Handling and Raising Events.