通过

WinForms 示例应用

  • 项目

此示例 WebView2WindowsFormsBrowser 演示如何使用 WebView2 控件和 WebView2 API 在 WinForms 应用中实现 Web 浏览器。

  • 示例名称： WebView2WindowsFormsBrowser
  • 存储库目录： WebView2WindowsFormsBrowser
  • 解决方案文件： WebView2WindowsFormsBrowser.sln

WebView2WindowsFormsBrowser 应用窗口

  • “ 控件 ”菜单具有 快捷键 和 “允许外部放置”的切换菜单项。
  • “ 视图 ”菜单具有 “缩放 ”和“ 背景色 ”子菜单。
  • “ 事件 ”按钮将打开 EventMonitor 窗口。

步骤 1 - 安装 Visual Studio

Microsoft Visual Studio 是必需的。 此示例不支持Microsoft Visual Studio Code。

  1. 如果尚未安装 Visual Studio (所需的最低版本) ，请参阅在为 WebView2 设置开发环境中的安装 Visual Studio。 按照该部分中的步骤进行操作，然后返回到此页并继续执行以下步骤。

步骤 2 - 克隆或下载 WebView2采样存储库

  1. 如果尚未执行此操作，请将 WebView2Samples 存储库克隆或下载到本地驱动器。 在单独的窗口或选项卡中，请参阅为 WebView2设置开发环境中的下载 WebView2 示例存储库。 按照该部分中的步骤操作，然后返回到此页面，然后继续以下操作。

步骤 3 - 在 Visual Studio 中打开.sln

  1. 在本地驱动器上 .sln ，在 Visual Studio 的目录中打开文件：

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

    或者：

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

步骤 4 - 在出现提示时安装工作负载

  1. 如果出现提示，请安装请求的任何 Visual Studio 工作负载。 在单独的窗口或选项卡中，请参阅为 WebView2 设置开发环境中的安装 Visual Studio 工作负载。 按照该部分中的步骤操作，然后返回到此页面，然后继续以下操作。

步骤 5 - 生成并运行项目

WebView2WindowsFormsBrowser 项目现已在 Visual Studio 中打开，完成上述步骤。 在 Visual Studio 的顶部，设置生成目标，如下所示：

  1. 在 “解决方案配置” 下拉列表中，选择“ 调试” 或“ 发布”。

  2. 在 “解决方案平台 ”下拉列表中，选择“ 任何 CPU”。

  3. 在“解决方案资源管理器”中，右键单击“WebView2WindowsFormsBrowser”项目，然后选择“生成”。

    这会生成项目文件 SampleApps/WebView2WindowsFormsBrowser/WebView2WindowsFormsBrowser.vcxproj。 这可能需要几分钟时间。

    如果收到有关缺少 .NET Framework 4.6.2 开发人员包的错误消息，请执行以下步骤。 否则，请跳到下面的下一个主要部分。

  4. 在 Visual Studio 中，选择“ 调试>开始调试 ” (F5) 。

    示例应用窗口随即打开：

    WebView2WindowsFormsBrowser 应用窗口

  5. 使用示例应用;请参阅 WebView2WindowsFormsBrowser 的自述文件。

  6. 在 Visual Studio 中，选择“ 调试>停止调试”。 Visual Studio 关闭应用。

步骤 6 - 安装 .NET Framework 4.6.2 开发人员包

如果生成 WebView2WindowsFormsBrowser 项目并收到有关缺少 .NET Framework 4.6.2 开发人员包的错误消息，请执行以下步骤。 否则，请跳到下面的下一个主要部分。

  1. 转到“下载.NET Framework，选择 v4.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开发人员包安装成功”对话框：

    Microsoft.NET Framework开发人员包“安装成功”对话框

  6. 单击“ 关闭 ”按钮。

Microsoft .NET Framework 4.6.2 开发人员工具包现已安装在计算机上。

步骤 7 - 更新或安装 WebView2 SDK

  1. WebView2 SDK - 在项目节点上更新或安装 WebView2 SDK， (而不是解决方案资源管理器中的解决方案节点) 。 在单独的窗口或选项卡中，请参阅为 WebView2 设置开发环境中的安装或更新 WebView2 SDK。 按照该部分中的步骤操作，然后返回到此页面，然后继续以下操作。

    Visual Studio 中的 WebView2WindowsFormsBrowser 项目

步骤 8 - 生成并运行更新的项目

  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. 在 “解决方案平台 ”下拉列表中，选择“ 任何 CPU”。

  3. 在“解决方案资源管理器”中，右键单击“WebView2WindowsFormsBrowser”项目，然后选择“生成”。

    这会生成项目文件 SampleApps/WebView2WindowsFormsBrowser/WebView2WindowsFormsBrowser.vcxproj。

  4. 在 Visual Studio 中，选择“ 调试>开始调试 ” (F5) 。

    示例应用窗口随即打开：

    WebView2WindowsFormsBrowser 应用窗口

    • “ 控件 ”菜单具有 快捷键 和 “允许外部放置”的切换菜单项。
    • “ 视图 ”菜单具有 “缩放 ”和“ 背景色 ”子菜单。
    • “ 事件 ”按钮将打开 EventMonitor 窗口。

  5. 在 Visual Studio 中，选择“ 调试>停止调试”。 Visual Studio 关闭应用。

步骤 9 - 检查代码

  1. 在 Visual Studio 代码编辑器中，检查代码：

    Visual Studio 中的 WebView2WindowsFormsBrowser 项目

另请参阅