WebView2

本页说明如何在 .NET Framework 窗体项目中使用官方 Microsoft.Web.WebView2.WinForms.WebView2 控件：运行时前置、在 LCode 中引用与放置、常用属性/方法，以及最小导航示例。面向传统 WinForms；凡有代码均同时给出 C# 5.0 与 VB.NET。设计器文案以 LCode 中文界面为准。

前置条件

在 LCode 中添加 WebView2

LCode 已集成官方控件到窗体设计器工具箱，并支持首次拖放时把 SDK 复制进工程（vendoring）。

方式一：工具箱拖放（推荐）

1. 按 窗体应用入门 建好「Windows 应用程序」项目，确认目标框架 ≥ 4.6.2。
2. 双击主窗体，底部切到设计页签。
3. 打开工具箱，在「Windows 窗体」相关分类中找到 WebView2 浏览器（通常排在「Web 浏览器」上方），拖到设计面。
4. 首次拖放时，LCode 会：
   • 将 SDK 复制到工程目录 packages\Microsoft.Web.WebView2.1.0.3967.48\（版本号以本机 LCode 自带为准）；
   • 添加对 Microsoft.Web.WebView2.Core 与 Microsoft.Web.WebView2.WinForms 的相对路径引用；
   • 配置 WebView2Loader.dll 复制到输出目录，并导入 WebView2.LCode.targets；
   • 可能弹出「WebView2 环境提示」（Runtime / 目标框架检查）。
5. 在属性面板将控件 Name 设为便于编码的名字（下文示例用 webView21），按需设置 Dock（如 Fill）。

方式二：代码 / 手工引用

若未使用拖放，可按 引用 DLL 手动添加程序集，再在代码中创建控件：

1. 从 LCode 安装目录的 data\WebView2\lib\net462\ 取得 Microsoft.Web.WebView2.Core.dll 与 Microsoft.Web.WebView2.WinForms.dll（或从已 vendoring 的工程 packages 复制整包）。
2. 在项目中添加上述两程序集引用；将对应架构的 WebView2Loader.dll 以 Content（链接）复制到输出目录根（文件名保持 WebView2Loader.dll）。
3. 在窗体构造函数（或 Load）中 new WebView2()、Controls.Add，并调用下文初始化与导航代码。

常用属性

常用方法与事件

最小实例：初始化并 Navigate

假设设计器已放置 webView21。在窗体 Load（或构造函数末尾）中初始化核心，再导航。C# 使用 async void 仅作窗体事件入口；业务逻辑中请优先 async Task。

using System;
using System.Windows.Forms;
using Microsoft.Web.WebView2.WinForms;

public partial class MainForm : Form
{
    public MainForm()
    {
        InitializeComponent();
    }

    private async void MainForm_Load(object sender, EventArgs e)
    {
        // 初始化核心；参数 null 表示使用默认环境
        await webView21.EnsureCoreWebView2Async(null);

        // 方式 A：CoreWebView2.Navigate
        webView21.CoreWebView2.Navigate("https://www.example.com/");

        // 方式 B（二选一）：直接设 Source
        // webView21.Source = new Uri("https://www.example.com/");
    }
}

Imports System
Imports System.Windows.Forms
Imports Microsoft.Web.WebView2.WinForms

Public Class MainForm
    Inherits Form

    Public Sub New()
        InitializeComponent()
    End Sub

    Private Async Sub MainForm_Load(sender As Object, e As EventArgs) Handles MyBase.Load
        ' 初始化核心；参数 Nothing 表示使用默认环境
        Await webView21.EnsureCoreWebView2Async(Nothing)

        ' 方式 A：CoreWebView2.Navigate
        webView21.CoreWebView2.Navigate("https://www.example.com/")

        ' 方式 B（二选一）：直接设 Source
        ' webView21.Source = New Uri("https://www.example.com/")
    End Sub
End Class

注意事项

相关阅读

• C# / VB.NET 窗体应用入门 — 创建窗体项目
• 引用 DLL — 手工添加程序集
• 运行与编译 — 输出目录与运行
• 异步、同步与多线程 — 异步与 UI 线程
• MDI 窗口模式 — 多文档子窗体生命周期