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

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

  • Статья

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

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

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

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

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

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

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

Шаг 2. Установка канала предварительной версии Microsoft Edge

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

  2. Чтобы заранее протестировать экспериментальные API-интерфейсы и обеспечить прямую совместимость приложения WebView2, см. статью Подходы к тому, чтобы приложение использовало определенный канал браузера в статье Тестирование предстоящих API и функций. Выполните действия, описанные в этом разделе, а затем вернитесь на эту страницу и выполните указанные ниже действия.

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

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

Шаг 4. Открытие SLN-файла в Visual Studio

  1. На локальном .sln диске откройте файл в Visual Studio в каталоге :

    • <your-repos-directory>/WebView2Samples/SampleApps/WebView2WindowsFormsBrowser/WebView2WindowsFormsBrowser.sln

    или

    • <your-repos-directory>/WebView2Samples-main/SampleApps/WebView2WindowsFormsBrowser/WebView2WindowsFormsBrowser.sln

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

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

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

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

  1. В раскрывающемся списке Конфигурации решений выберите Отладка или Выпуск.

  2. В раскрывающемся списке Платформы решений выберите Любой ЦП.

  3. В Обозреватель решений щелкните правой кнопкой мыши проект WebView2WindowsFormsBrowser и выберите Сборка.

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

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

  4. В Visual Studio выберите Отладка>Начать отладку (F5).

    Откроется окно примера приложения:

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

  5. Используйте пример приложения; см . файл README для WebView2WindowsFormsBrowser.

  6. В Visual Studio выберите Отладка>Остановить отладку. Visual Studio закрывает приложение.

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

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

  1. Перейдите в раздел Скачать платформа .NET Framework, выберите версию 4.6.2 и нажмите кнопку Скачать пакет разработчика платформа .NET Framework 4.6.2:

    Скачивание пакета разработчика платформа .NET Framework 4.6.2

  2. В Microsoft Edge выберите Параметры и другие>загрузки>Показать в папке значок:

    Скачивание пакета разработчика платформа .NET Framework

  3. В папке Downloads дважды щелкните файл, например ndp462-devpack-kb3151934-enu.exe.

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

    Диалоговое окно лицензионного соглашения пакета разработчика Microsoft платформа .NET Framework

  4. Установите флажок Я принимаю условия лицензии и нажмите кнопку Установить .

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

  5. Нажмите кнопку Да .

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

    Диалоговое окно

  6. Нажмите кнопку Закрыть .

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

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

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

    Проект WebView2WindowsFormsBrowser в Visual Studio

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

  1. Если вы только что установили пакет разработчика платформа .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 задайте целевой объект сборки следующим образом:

  1. В раскрывающемся списке Конфигурации решений выберите Отладка или Выпуск.

  2. В раскрывающемся списке Платформы решений выберите Любой ЦП.

  3. В Обозреватель решений щелкните правой кнопкой мыши проект WebView2WindowsFormsBrowser и выберите Сборка.

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

  4. В Visual Studio выберите Отладка>Начать отладку (F5).

    Откроется окно примера приложения:

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

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

  5. В Visual Studio выберите Отладка>Остановить отладку. Visual Studio закрывает приложение.

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

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

    Проект WebView2WindowsFormsBrowser в Visual Studio

См. также