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. 如果尚未执行此操作,请将 WebView2Sample 存储库克隆或下载到本地驱动器。 在单独的窗口或选项卡中,请参阅为 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 项目

另请参阅