Пример приложения WinForms

Статья
08/02/2024

В этом примере WebView2WindowsFormsBrowser показано, как использовать элемент управления WebView2 и API WebView2 для реализации веб-браузера в приложении WinForms.

Имя примера: WebView2WindowsFormsBrowser
Каталог репозитория: WebView2WindowsFormsBrowser
Файл решения: WebView2WindowsFormsBrowser.sln

Окно приложения WebView2WindowsFormsBrowser

В меню Управление есть переключатели меню для клавиш акселератора и Разрешить внешнее удаление.
Меню Вид содержит подменю Масштаб и Цвет фона .
Кнопка События открывает окно EventMonitor .

Шаг 1. Установка Visual Studio

Требуется Microsoft Visual Studio. Microsoft Visual Studio Code не поддерживается в этом примере.

Если Visual Studio (минимальная требуемая версия) еще не установлена, в отдельном окне или на вкладке см . статью Установка Visual Studioстатьи Настройка среды разработки для WebView2. Выполните действия, описанные в этом разделе, а затем вернитесь на эту страницу и выполните указанные ниже действия.

Шаг 2. Клонирование или скачивание репозитория WebView2Samples

Если это еще не сделано, клонируйте или скачайте репозиторий WebView2Samples на локальный диск. В отдельном окне или на вкладке см . раздел Скачивание репозитория WebView2Samplesстатьи Настройка среды разработки для WebView2. Выполните действия, описанные в этом разделе, а затем вернитесь на эту страницу и продолжите работу ниже.

Шаг 3. Открытие .sln в Visual Studio

На локальном .sln диске откройте файл в Visual Studio в каталоге :
- <your-repos-directory>/WebView2Samples/SampleApps/WebView2WindowsFormsBrowser/WebView2WindowsFormsBrowser.sln
или
- <your-repos-directory>/WebView2Samples-main/SampleApps/WebView2WindowsFormsBrowser/WebView2WindowsFormsBrowser.sln

Шаг 4. Установка рабочих нагрузок при появлении запроса

При появлении запроса установите все запрошенные рабочие нагрузки Visual Studio. В отдельном окне или вкладке см . статью Установка рабочих нагрузок Visual Studioстатьи Настройка среды разработки для WebView2. Выполните действия, описанные в этом разделе, а затем вернитесь на эту страницу и продолжите работу ниже.

Шаг 5. Сборка и запуск проекта

Проект WebView2WindowsFormsBrowser теперь открыт в Visual Studio, выполнив указанные выше действия. В верхней части Visual Studio задайте целевой объект сборки следующим образом:

В раскрывающемся списке Конфигурации решений выберите Отладка или Выпуск.
В раскрывающемся списке Платформы решений выберите Любой ЦП.
В Обозреватель решений щелкните правой кнопкой мыши проект WebView2WindowsFormsBrowser и выберите Сборка.

При этом создается файл SampleApps/WebView2WindowsFormsBrowser/WebView2WindowsFormsBrowser.vcxprojпроекта . Это может занять несколько минут.

Если появляется сообщение об ошибке об отсутствии пакета разработчика платформа .NET Framework 4.6.2, выполните следующие действия. В противном случае перейдите к следующему основному разделу ниже.
В Visual Studio выберите Отладка>Начать отладку (F5).

Откроется окно примера приложения:
Используйте пример приложения; см . файл README для WebView2WindowsFormsBrowser.
В Visual Studio выберите Отладка>Остановить отладку. Visual Studio закрывает приложение.

Шаг 6. Установка пакета разработчика платформа .NET Framework 4.6.2

Если вы создаете проект WebView2WindowsFormsBrowser и получаете сообщения об ошибках об отсутствии пакета разработчика платформа .NET Framework 4.6.2, выполните следующие действия. В противном случае перейдите к следующему основному разделу ниже.

Перейдите в раздел Скачать платформа .NET Framework, выберите версию 4.6.2 и нажмите кнопку Скачать пакет разработчика платформа .NET Framework 4.6.2:
В Microsoft Edge выберите Параметры и другие>загрузки>Показать в папке значок:
В папке Downloads дважды щелкните файл, например ndp462-devpack-kb3151934-enu.exe.

Откроется диалоговое окно лицензионного соглашения пакета разработчика Microsoft платформа .NET Framework:
Установите флажок Я принимаю условия лицензии и нажмите кнопку Установить .

Откроется окно Контроля учетных записей пользователей с вопросом "Разрешить ли этому приложению вносить изменения в устройство?"
Нажмите кнопку Да .

Откроется диалоговое окно Установка пакета разработчика Microsoft платформа .NET Framework:
Нажмите кнопку Закрыть .

Microsoft .NET Framework 4.6.2 Developer Pack теперь установлен на компьютере.

Шаг 7. Обновление или установка пакета SDK для WebView2

Пакет SDK для WebView2— обновление или установка пакета SDK для WebView2 на узле проекта (а не на узле решения) в Обозреватель решений. В отдельном окне или вкладке см. статью Установка или обновление пакета SDK для WebView2статьи Настройка среды разработки для WebView2. Выполните действия, описанные в этом разделе, а затем вернитесь на эту страницу и продолжите работу ниже.

Шаг 8. Сборка и запуск обновленного проекта

Если вы только что установили пакет разработчика платформа .NET Framework 4.6.2 выше, закройте Visual Studio, а затем снова откройте файл решения в Visual Studio из каталога:
- <your-repos-directory>/WebView2Samples/SampleApps/WebView2WindowsFormsBrowser/WebView2WindowsFormsBrowser.sln
или
- <your-repos-directory>/WebView2Samples-main/SampleApps/WebView2WindowsFormsBrowser/WebView2WindowsFormsBrowser.sln

В верхней части Visual Studio задайте целевой объект сборки следующим образом:

В раскрывающемся списке Конфигурации решений выберите Отладка или Выпуск.
В раскрывающемся списке Платформы решений выберите Любой ЦП.
В Обозреватель решений щелкните правой кнопкой мыши проект WebView2WindowsFormsBrowser и выберите Сборка.

При этом создается файл SampleApps/WebView2WindowsFormsBrowser/WebView2WindowsFormsBrowser.vcxprojпроекта .
В Visual Studio выберите Отладка>Начать отладку (F5).

Откроется окно примера приложения:
- В меню Управление есть переключатели меню для клавиш акселератора и Разрешить внешнее удаление.
- Меню Вид содержит подменю Масштаб и Цвет фона .
- Кнопка События открывает окно EventMonitor .
В Visual Studio выберите Отладка>Остановить отладку. Visual Studio закрывает приложение.

Шаг 9. Проверка кода

В редакторе кода Visual Studio проверьте код:

Поделиться через