WPF中使用WebView2控件的方法及常见问题

下面是详细的“WPF中使用WebView2控件的方法及常见问题”的攻略。

什么是WebView2控件

WebView2控件是一个新的Web浏览器控件，用于在Windows应用程序中嵌入Web体验，具备所有现代Web浏览器的特性。

WebView2控件是使用Microsoft Edge浏览器的渲染引擎构建的。

WebView2控件的优势

相对于Windows自带的WebBrowser控件，WebView2控件具有如下优势：

• 支持多种浏览器引擎
• 支持所有现代Web技术
• 支持比WebBrowser更好的性能和更好的兼容性
• 支持更好的安全性和隐私保护

WPF中使用WebView2控件的方法

以下是在WPF应用程序中使用WebView2控件的步骤：

第一步：安装Microsoft.WebView2 NuGet程序包

可以使用Visual Studio的NuGet Package Manager安装Microsoft.WebView2 NuGet程序包。安装后，会在项目依赖项中添加以下引用：

• Microsoft.Web.WebView2.Core.dll
• Microsoft.Web.WebView2.WinForms.dll
• Microsoft.Web.WebView2.Wpf.dll

第二步：在XAML布局中添加WebView2控件

在WPF应用程序的XAML布局中，使用以下代码向布局中添加WebView2控件：

<Window x:Class="WpfWebView2Sample.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:wv2="clr-namespace:Microsoft.Web.WebView2.Wpf;assembly=Microsoft.Web.WebView2.Wpf"
        Title="WPF WebView2" Height="450" Width="800">
    <Grid>
        <wv2:WebView2 x:Name="webView"/>
    </Grid>
</Window>

第三步：在代码中初始化WebView2控件

在代码中，使用以下代码初始化WebView2控件：

using Microsoft.Web.WebView2.Core;

...

public MainWindow()
{
    InitializeComponent();

    // 初始化WebView2控件
    webView.CreationProperties = new CoreWebView2CreationProperties()
    {
        BrowserExecutableFolder = @"C:\Program Files (x86)\Microsoft\Edge\Application\92.0.902.62"
    };
    webView.CoreWebView2InitializationCompleted += WebView_CoreWebView2InitializationCompleted;
    webView.EnsureCoreWebView2Async();
}

private void WebView_CoreWebView2InitializationCompleted(object sender, CoreWebView2InitializationCompletedEventArgs e)
{
    // WebView2控件已初始化完成
    if (e.IsSuccess)
    {
        webView.CoreWebView2.Navigate("https://www.baidu.com");
    }
    else
    {
        MessageBox.Show($"WebView2初始化失败：{e.InitializationException}");
    }
}

代码中的BrowserExecutableFolder属性指定了使用哪个浏览器引擎。可以将其设置为你系统中已安装的任何兼容的浏览器引擎的文件夹路径。

CoreWebView2InitializationCompleted事件表示WebView2控件已初始化完成。在此事件处理程序中，可以调用Navigate方法加载Web页面。

WebView2控件的常见问题

以下是使用WebView2控件时可能会遇到的一些常见问题：

问题一：无法初始化WebView2控件

如果使用CreateCoreWebView2EnvironmentAsync方法无法进行Web页面导航并引发错误：HRESULT：0x80072EE7，则可能是由于Web页面安全协议使用的TLS版本未受支持。可以在控制面板的Internet选项中将TLS版本设置为1.2或更高版本。

问题二：无法加载浏览器引擎

如果初始化WebView2控件时无法加载浏览器引擎，则可能是由于未安装兼容的浏览器引擎。请尝试在WebView2控件的CreationProperties.BrowserExecutableFolder属性中指定另一个浏览器引擎的文件夹路径。

示例一：使用WebView2控件打开本地HTML文件

以下示例演示如何在WebView2控件中打开本地HTML文件：

string htmlPath = @"C:\path\to\local\file.html";
string html = File.ReadAllText(htmlPath);
webView.CoreWebView2.NavigateToString(html);

可以使用NavigateToString方法将本地HTML文件的内容加载到WebView2控件中。

示例二：使用WebView2控件调用JavaScript函数

以下示例演示如何使用WebView2控件调用JavaScript函数：

webView.CoreWebView2.AddScriptToExecuteOnDocumentCreatedAsync("function showAlert() { alert('Hello, WebView2!'); }");
await webView.CoreWebView2.ExecuteScriptAsync("showAlert();");

可以使用AddScriptToExecuteOnDocumentCreatedAsync方法将JavaScript脚本添加到Web页面中，在Web页面创建时自动执行。可以使用ExecuteScriptAsync方法从C#代码中调用JavaScript函数。