WinForms中如何嵌入Web浏览器控件？

安装： 首先，你需要通过NuGet包管理器将

Microsoft.Web.WebView2

Install-Package Microsoft.Web.WebView2

集成： 安装完成后，你可以在工具箱中找到

WebView2

using Microsoft.Web.WebView2.WinForms;
using System.Windows.Forms;
public partial class MainForm : Form
{
    private WebView2 webView2;
    public MainForm()
    {
        InitializeComponent();
        InitializeWebView2();
    }
    private async void InitializeWebView2()
    {
        webView2 = new WebView2();
        this.Controls.Add(webView2);
        webView2.Dock = DockStyle.Fill;
        // 确保WebView2运行时已准备好
        // 这一步很重要，因为CoreWebView2Environment是异步初始化的
        await webView2.EnsureCoreWebView2Async(null);
        // 加载一个URL
        webView2.CoreWebView2.Navigate("https://www.bing.com");
    }
}

核心优势： 现代Web标准支持、高性能、与Edge浏览器一致的渲染效果、强大的JavaScript互操作性。在我看来，任何新项目都应该优先考虑它。

集成：

WebBrowser

基本使用：

using System.Windows.Forms;
public partial class MainForm : Form
{
    private WebBrowser webBrowser;
    public MainForm()
    {
        InitializeComponent();
        InitializeWebBrowser();
    }
    private void InitializeWebBrowser()
    {
        webBrowser = new WebBrowser();
        this.Controls.Add(webBrowser);
        webBrowser.Dock = DockStyle.Fill;
        // 加载一个URL
        webBrowser.Navigate("https://www.bing.com");
    }
}

局限性： 无法显示大部分现代网站，性能低下，缺乏安全性更新，且Microsoft已停止支持IE。把它用在新项目里，简直是给自己挖坑。

执行JavaScript代码： 这是最直接的方式，你可以在WinForms中直接调用Web页面上的JavaScript函数，或者执行一段JavaScript代码来修改DOM、触发事件等。

// 假设Web页面上有一个名为'updateMessage'的JavaScript函数
// function updateMessage(msg) { document.getElementById('output').innerText = msg; }
string script = "updateMessage('Hello from WinForms!');";
await webView2.CoreWebView2.ExecuteScriptAsync(script);
// 或者直接修改DOM
string domScript = "document.getElementById('header').innerText = '新的标题';";
await webView2.CoreWebView2.ExecuteScriptAsync(domScript);

ExecuteScriptAsync

发送Web消息（推荐用于结构化数据）：

WebView2

using Newtonsoft.Json; // 需要安装Newtonsoft.Json NuGet包
public class MessageData
{
    public string Type { get; set; }
    public string Content { get; set; }
}
// 在WinForms中发送消息
var data = new MessageData { Type = "updateUI", Content = "这是来自C#的数据" };
string jsonMessage = JsonConvert.SerializeObject(data);
webView2.CoreWebView2.PostWebMessageAsJson(jsonMessage);

在Web页面中，你需要监听

window.chrome.webview.addEventListener('message', ...)

// 在Web页面的JavaScript中
window.chrome.webview.addEventListener('message', event => {
    // event.data 就是从WinForms发送过来的JSON字符串
    const message = JSON.parse(event.data);
    console.log('Received message from C#:', message);
    if (message.Type === 'updateUI') {
        document.getElementById('webOutput').innerText = message.Content;
    }
});

在Web页面中发送消息：

<!-- 假设Web页面上有一个按钮 -->
<button onclick="sendMessageToCSharp()">发送消息到C#</button>
<script>
    function sendMessageToCSharp() {
        const data = {
            action: 'buttonClicked',
            timestamp: new Date().toISOString()
        };
        // 发送JSON字符串
        window.chrome.webview.postMessage(JSON.stringify(data));
        // 或者直接发送对象 (WebView2会自动序列化为JSON)
        // window.chrome.webview.postWebMessageAsJson(data);
    }
</script>

在WinForms中接收消息：

public partial class MyForm : Form
{
    // ... (WebView2初始化代码)
    private void InitializeMyWebView()
    {
        // ...
        await webView.EnsureCoreWebView2Async(null);
        // 订阅WebMessageReceived事件
        webView.CoreWebView2.WebMessageReceived += CoreWebView2_WebMessageReceived;
        // ...
    }
    private void CoreWebView2_WebMessageReceived(object sender, Microsoft.Web.WebView2.Core.CoreWebView2WebMessageReceivedEventArgs e)
    {
        // 获取Web页面发送过来的JSON字符串
        string message = e.WebMessageAsJson;
        // 或者如果是简单字符串，可以用 e.WebMessageAsString
        // 解析JSON
        try
        {
            var receivedData = JsonConvert.DeserializeObject<MessageData>(message);
            MessageBox.Show($"从Web收到消息: 类型={receivedData.Type}, 内容={receivedData.Content}");
            // 根据消息内容执行WinForms的逻辑
            if (receivedData.Type == "buttonClicked")
            {
                this.Invoke(new Action(() =>
                {
                    // 在UI线程更新UI
                    this.Text = "Web页面按钮被点击了！";
                }));
            }
        }
        catch (JsonException ex)
        {
            MessageBox.Show($"解析Web消息失败: {ex.Message}");
        }
    }
}

注意：

WebMessageReceived

Invoke

BeginInvoke