摘要:WebView2 是 Microsoft 提供的一种嵌入式浏览器控件,基于 Edge (Chromium) 引擎。
WebView2 是 Microsoft 提供的一种嵌入式浏览器控件,基于 Edge (Chromium) 引擎。
它允许开发者将现代 Web 技术(如 HTML、CSS 和 JavaScript)与桌面应用相结合,从而构建强大、灵活的用户界面。
本文将介绍 WebView2 的基本使用,并重点讲解以下几个重要功能:
NewWindowrequested
WebResourceResponseReceived
AddWebResourceRequestedFilter
WebResourceRequested
环境准备安装 WebView2 Runtime:WebView2 需要运行时支持,用户设备必须安装 WebView2 Runtime。如果未安装,可以通过以下链接下载:https://go.microsoft.com/fwlink/p/?LinkId=2124703。
引入必要的 NuGet 包:在 Visual Studio 中,添加 Microsoft.Web.WebView2NuGet 包。
初始化 WebView2:创建 WebView2 控件并确保其已正确初始化。以下代码检查并安装 WebView2 Runtime:
private static async Task InitializeWebView2{ try { string version = CoreWebView2Environment.GetAvailableBrowserVersionString; return !string.IsOrEmpty(version); } catch { // 引导用户安装 WebView2 Runtime MessageBox.Show("WebView2 Runtime 未安装。请安装后重试。", "错误", MessageBoxButtons.OK, MessageBoxIcon.Error); return false; }}创建 WebView2 控件以下代码展示了如何创建 WebView2 控件并初始化其核心功能:
public static async Task CreateWebView{ if (!await InitializeWebView2) { return ; } WebView2 webView2 = new WebView2 { Dock = DockStyle.Fill }; await webView2.EnsureCoreWebView2Async; // 注册事件 webView2.CoreWebView2.NewWindowRequested += CoreWebView2_NewWindowRequested; webView2.CoreWebView2.WebResourceResponseReceived += CoreWebView2_WebResourceResponseReceived; // 添加请求过滤器 webView2.CoreWebView2.AddWebResourceRequestedFilter("*://www.example.com/*", CoreWebView2WebResourceContext.Document); webView2.CoreWebView2.WebResourceRequested += WebView2_WebResourceRequested; return webView2;}拦截新窗口请求:NewWindowRequested默认情况下,WebView2 会尝试在新窗口中打开弹出链接。通过NewWindowRequested事件,我们可以拦截弹窗行为并将新内容加载到当前窗口。示例代码:
private static void CoreWebView2_NewWindowRequested(object sender, CoreWebView2NewWindowRequestedEventArgs e){ if (sender is CoreWebView2 webView) { e.Handled = true; // 阻止默认弹窗行为 webView.Navigate(e.Uri); // 在当前 WebView2 中加载新页面 }}通过WebResourceResponseReceived,我们可以查看并分析所有网络响应。例如,可以记录某些请求的响应时间或检查响应头信息。示例代码:
private static void CoreWebView2_WebResourceResponseReceived(object sender, CoreWebView2WebResourceResponseReceivedEventArgs e){ var uri = e.Request.Uri; Console.WriteLine($"Response received for: {uri}"); e.Response.headers.ToList.ForEach(Header => { Console.WriteLine($"Header: {header.Key} - {header.Value}"); });}为了提高性能并精确控制,WebView2 提供了AddWebResourceRequestedFilter方法,用于定义需要监听的请求类型和范围。使用方法:
webView.CoreWebView2.AddWebResourceRequestedFilter( "*://www.example.com/*", // 目标 URL 模式 CoreWebView2WebResourceContext.Document // 资源类型:仅文档);拦截网络请求:WebResourceRequested通过WebResourceRequested事件,可以拦截网络请求并进行处理,例如修改请求头或阻止特定请求。示例代码:
private static async void WebView2_WebResourceRequested(object sender, CoreWebView2WebResourceRequestedEventArgs e){ var request = e.Request; // 检查是否有特定 Cookie if (sender is CoreWebView2 webView) { var cookies = (await webView.CookieManager.GetCookiesAsync(request.Uri)) .Where(c => c.Name == "SpecificCookie").ToList; if (cookies.Any) { // 删除特定 Cookie cookies.ForEach(c => webView.CookieManager.DeleteCookie(c)); } } Console.WriteLine($"Request intercepted: {request.Uri}");}总结WebView2 是一个强大的控件,为开发者提供了丰富的功能来控制和定制 Web 资源的加载行为。通过本文介绍的事件和方法,你可以:
阻止默认弹窗行为 (NewWindowRequested)
分析网络响应 (WebResourceResponseReceived)
精确过滤需要拦截的请求 (AddWebResourceRequestedFilter)
修改或阻止网络请求 (WebResourceRequested)
借助这些功能,可以更灵活地将 Web 内容集成到桌面应用程序中,满足各种业务需求。
来源:opendotnet