WebView2 功能和 API 概述

在应用中嵌入 WebView2 控件可让你的应用访问通过 WebView2 类或接口提供的各种方法和属性。 WebView2 具有数百个 API，提供大量功能，从增强应用的本机平台功能到使应用能够修改浏览器体验。 本文提供 WebView2 API 的高级分组，以帮助你了解可以使用 WebView2 执行的不同操作。

顶级功能区域概述

托管 WebView2 控件时，你的应用有权访问以下功能和 API：

功能区域	用途
主类：Environment、Controller 和 Core	CoreWebView2Environment (或等效接口的 、 CoreWebView2Controller和 CoreWebView2 类) 协同工作，以便应用可以托管 WebView2 浏览器控件并访问其浏览器功能。 这些大型类公开了各种 API，主机应用可以访问这些 API，以便为用户提供以下类别的浏览器相关功能。
Web/本机互操作	将 Web 内容嵌入本机应用程序。 使用简单消息、JavaScript 代码和本机对象在本机代码和 Web 代码之间进行通信。
浏览器功能	WebView2 控件允许应用访问许多浏览器功能。 可以修改这些浏览器功能并打开或关闭它们。
进程管理	获取有关运行 WebView2 进程、退出进程和失败进程的信息，以便应用可以采取相应的操作。
导航到页面并管理加载的内容	管理网页导航并管理网页中加载的内容。
iframes	将其他网页嵌入你自己的网页。 检测何时创建嵌入网页，检测嵌入网页何时导航，并选择性地绕过 x 帧选项。
身份验证	应用可以使用 WebView2 控件处理基本身份验证。 基本身份验证 是 HTTP 协议的一部分的特定身份验证方法。
在非框架应用中呈现 WebView2	如果主机应用不使用 UI 框架，请使用这些 API 设置 WebView2 呈现系统。 此呈现设置控制 WebView2 如何将输出呈现到主机应用中，以及 WebView2 如何处理输入、焦点和辅助功能。
使用合成呈现 WebView2	对于基于合成的 WebView2 呈现，请使用 CoreWebView2Environment 创建 CoreWebView2CompositionController。 CoreWebView2CompositionController 提供与 相同的 API CoreWebView2Controller，但也包括用于基于合成的呈现的 API。
环境选项	用户数据： (UDF) （用户计算机上的文件夹）管理用户数据文件夹。 UDF 包含与主机应用和 WebView2 相关的数据。 WebView2 应用使用用户数据文件夹来存储浏览器数据，例如 Cookie、权限和缓存的资源。 在单个 UDF 下管理多个配置文件。 运行时选择 支持预发布测试和自承载。 可以指定浏览器预览通道的搜索顺序，并指定要搜索的浏览器预览通道。
性能和调试	分析和调试性能，处理与性能相关的事件，并管理内存使用情况，以提高应用的响应能力。
Chrome DevTools 协议 (CDP)	检测、检查、调试和分析基于Chromium的浏览器。 Chrome DevTools 协议 (CDP) 是 Microsoft Edge DevTools 的基础。 将 Chrome DevTools 协议用于 WebView2 平台中未实现的功能。

此页仅列出发布 SDK 中的 API;它不会列出在发布 SDK 中尚不可用的实验 API 或稳定 API。 有关包括实验 API 在内的 API 的完整列表，请参阅 WebView2 SDK 的发行说明。

主类：Environment、Controller 和 Core

CoreWebView2Environment (或等效接口的 、 CoreWebView2Controller和 CoreWebView2 类) 协同工作，以便应用可以托管 WebView2 浏览器控件并访问其浏览器功能。 这三个大类公开了各种 API，主机应用可以访问这些 API，从而为用户提供许多与浏览器相关的功能类别。

• 类 CoreWebView2Environment 表示一组 WebView2 控件，这些控件共享相同的 WebView2 浏览器进程、用户数据文件夹和呈现器进程。 在此类CoreWebView2Environment中，将创建 和 CoreWebView2 实例对CoreWebView2Controller。
• 类 CoreWebView2Controller 负责与托管相关的功能，例如窗口焦点、可见性、大小和输入，应用在其中托管 WebView2 控件。
• 类 CoreWebView2 适用于 WebView2 控件的特定于 Web 的部分，包括网络、导航、脚本以及分析和呈现 HTML。

另请参阅：

• WebView2 的主类：环境、控制器和核心

.NET/C#

• CoreWebView2 类
• CoreWebView2Controller 类
• CoreWebView2Environment 类

WinRT/C#

• CoreWebView2 类
• CoreWebView2Controller 类
• CoreWebView2Environment 类

Win32/C++

• ICoreWebView2
• ICoreWebView2Controller
• ICoreWebView2Environment

Web/本机互操作

Microsoft Edge WebView2 控件允许将 Web 内容嵌入本机应用程序。 可以使用简单消息、JavaScript 代码和本机对象在本机代码和 Web 代码之间进行通信。 下面是用于在 Web 和本机代码之间进行通信的main API。

以下小节：

• 主机/Web 对象共享
• 脚本执行
• Web 消息传送
• 脚本对话框
• 共享缓冲区

Web/本机互操作的常见用例：

• 导航到其他网站后，更新本机主机窗口标题。
• 从 Web 应用发送本机相机对象并使用其方法。
• 在应用程序的 Web 端运行专用 JavaScript 文件。

另请参阅：

• 本机端和 Web 端代码的互操作
• 从本机端代码调用 Web 端代码
• 从 Web 端代码调用本机端代码
• 从 Web 端代码调用本机 WinRT 代码
• 适用于 JavaScript API 的 WebView2window.chrome.webview 中的 JavaScript API

主机/Web 对象共享

WebView2 允许将本机代码中定义的对象传递给应用的 Web 端代码。 主机对象 是在本机代码中定义的任何对象，你选择传递给应用的 Web 端代码。

可以将主机对象投影到 JavaScript 中，以便你可以从应用的 Web 端代码 (或其他 API) 调用本机对象方法。 例如，应用可以通过应用 Web 端的用户交互调用此类 API。 这样，就无需在 Web 端代码中重新实现本机对象的 API，例如方法或属性。

.NET/C#

• CoreWebView2 类：
  • CoreWebView2.AddHostObjectToScript 方法
  • CoreWebView2.RemoveHostObjectFromScript 方法
• CoreWebView2Settings 类：
  • CoreWebView2Settings.AreHostObjectsAllowed 属性

WinRT/C#

• CoreWebView2 类：
  • CoreWebView2.AddHostObjectToScript 方法
  • CoreWebView2.RemoveHostObjectFromScript 方法
• CoreWebView2Settings 类：
  • CoreWebView2Settings.AreHostObjectsAllowed 属性
• CoreWebView2Frame 类：
  • CoreWebView2Frame.RemoveHostObjectFromScript 方法

Win32/C++

• ICoreWebView2 接口：
  • ICoreWebView2：：AddHostObjectToScript 方法
  • ICoreWebView2：：RemoveHostObjectFromScript 方法
• ICoreWebView2Settings 接口：
  • ICoreWebView2Settings：：get_AreHostObjectsAllowed 方法
  • ICoreWebView2Settings：:p ut_AreHostObjectsAllowed 方法
• ICoreWebView2Frame 接口：
  • ICoreWebView2Frame：：AddHostObjectToScriptWithOrigins 方法

脚本执行

允许主机应用在 WebView2 控件内的 Web 内容中添加 JavaScript 代码。

.NET/C#

• CoreWebView2 类：
  • CoreWebView2.AddScriptToExecuteOnDocumentCreatedAsync 方法
  • CoreWebView2.ExecuteScriptAsync 方法
  • CoreWebView2.ExecuteScriptWithResultAsync 方法
  • CoreWebView2.RemoveScriptToExecuteOnDocumentCreated 方法
• CoreWebView2ExecuteScriptResult 类
  • CoreWebView2ExecuteScriptResult.Exception 属性
  • CoreWebView2ExecuteScriptResult.ResultAsJson 属性
  • CoreWebView2ExecuteScriptResult.Succeeded 属性
  • CoreWebView2ExecuteScriptResult.TryGetResultAsString 方法
• CoreWebView2Frame 类：
  • CoreWebView2Frame.ExecuteScriptAsync 方法
• CoreWebView2ScriptException 类
  • CoreWebView2ScriptException.ColumnNumber 属性
  • CoreWebView2ScriptException.LineNumber 属性
  • CoreWebView2ScriptException.Message 属性
  • CoreWebView2ScriptException.Name 属性
  • CoreWebView2ScriptException.ToJson 属性
• CoreWebView2Settings 类：
  • CoreWebView2Settings.IsScriptEnabled 属性

WinRT/C#

• CoreWebView2 类：
  • CoreWebView2.AddScriptToExecuteOnDocumentCreatedAsync 方法
  • CoreWebView2.ExecuteScriptAsync 方法
  • CoreWebView2.ExecuteScriptWithResultAsync 属性
  • CoreWebView2.RemoveScriptToExecuteOnDocumentCreated 方法
• CoreWebView2ExecuteScriptResult 类
  • CoreWebView2ExecuteScriptResult.Exception 属性
  • CoreWebView2ExecuteScriptResult.ResultAsJson 属性
  • CoreWebView2ExecuteScriptResult.Succeeded 属性
  • CoreWebView2ExecuteScriptResult.TryGetResultAsString 属性
• CoreWebView2Frame 类：
  • CoreWebView2Frame.ExecuteScriptAsync 方法
• CoreWebView2ScriptException 类
  • CoreWebView2ScriptException.ColumnNumber 属性
  • CoreWebView2ScriptException.LineNumber 属性
  • CoreWebView2ScriptException.Message 属性
  • CoreWebView2ScriptException.Name 属性
  • CoreWebView2ScriptException.ToJson 属性
• CoreWebView2Settings 类：
  • CoreWebView2Settings.IsScriptEnabled 属性

Win32/C++

• ICoreWebView2 接口：
  • ICoreWebView2：：AddScriptToExecuteOnDocumentCreated 方法
  • ICoreWebView2：：ExecuteScript 方法
  • ICoreWebView2：：RemoveScriptToExecuteOnDocumentCreated 方法
• ICoreWebView2_21
  • ICoreWebView2_21：：ExecuteScriptWithResult
• ICoreWebView2ExecuteScriptResult
  • ICoreWebView2ExecuteScriptResult：：get_Exception
  • ICoreWebView2ExecuteScriptResult：：get_ResultAsJson
  • ICoreWebView2ExecuteScriptResult：：get_Succeeded
  • ICoreWebView2ExecuteScriptResult：：TryGetResultAsString
• ICoreWebView2ExecuteScriptWithResultCompletedHandler
• ICoreWebView2Frame2 接口：
  • ICoreWebView2Frame2：：ExecuteScript 方法
• ICoreWebView2ScriptException
  • ICoreWebView2ScriptException：：get_ColumnNumber
  • ICoreWebView2ScriptException：：get_LineNumber
  • ICoreWebView2ScriptException：：get_Message
  • ICoreWebView2ScriptException：：get_Name
  • ICoreWebView2ScriptException：：get_ToJson
• ICoreWebView2Settings 接口：
  • ICoreWebView2Settings：：get_IsScriptEnabled 方法
  • ICoreWebView2Settings：:p ut_IsScriptEnabled 方法

Web 消息传送

你的应用可以将消息发送到 WebView2 控件中的 Web 内容，并从该 Web 内容接收消息。 消息以字符串或 JSON 对象的形式发送。

.NET/C#

• CoreWebView2 类：
  • CoreWebView2.PostWebMessageAsJson 方法
  • CoreWebView2.PostWebMessageAsString 方法
  • CoreWebView2.WebMessageReceived 事件
• CoreWebView2WebMessageReceivedEventArgs 类
• CoreWebView2Settings 类：
  • CoreWebView2Settings.IsWebMessageEnabled 属性
• CoreWebView2Frame 类：
  • CoreWebView2Frame.PostWebMessageAsJson 方法
  • CoreWebView2Frame.PostWebMessageAsString 方法
  • CoreWebView2Frame.WebMessageReceived 事件
• CoreWebView2File 类
  • CoreWebView2File.Path 属性

WinRT/C#

• CoreWebView2 类：
  • CoreWebView2.PostWebMessageAsJson 方法
  • CoreWebView2.PostWebMessageAsString 方法
  • CoreWebView2.WebMessageReceived 事件
• CoreWebView2WebMessageReceivedEventArgs 类
• CoreWebView2Settings 类：
  • CoreWebView2Settings.IsWebMessageEnabled 属性
• CoreWebView2Frame 类：
  • CoreWebView2Frame.PostWebMessageAsJson 方法
  • CoreWebView2Frame.PostWebMessageAsString 方法
  • CoreWebView2Frame.WebMessageReceived 事件
• CoreWebView2File 类
  • CoreWebView2File.Path 属性

Win32/C++

• ICoreWebView2 接口：
  • ICoreWebView2：:P ostWebMessageAsJson 方法
  • ICoreWebView2：:P ostWebMessageAsString 方法
  • ICoreWebView2：：add_WebMessageReceived
  • ICoreWebView2：：remove_WebMessageReceived
• ICoreWebView2WebMessageReceivedEventArgs 接口
• ICoreWebView2WebMessageReceivedEventArgs2 接口
• ICoreWebView2Settings 接口：
  • ICoreWebView2Settings：：get_IsWebMessageEnabled
  • ICoreWebView2Settings：:p ut_IsWebMessageEnabled
• ICoreWebView2Frame2 接口：
  • ICoreWebView2Frame2：:P ostWebMessageAsJson 方法
  • ICoreWebView2Frame2：:P ostWebMessageAsString 方法
  • ICoreWebView2Frame2：：add_WebMessageReceived
  • ICoreWebView2Frame2：：remove_WebMessageReceived
• ICoreWebView2File 接口
  • ICoreWebView2File：：get_Path
• ICoreWebView2ObjectCollectionView 接口

脚本对话框

托管 WebView2 时，你的应用可以管理不同的 JavaScript 对话，以禁止显示它们或将其替换为自定义对话。

.NET/C#

• CoreWebView2 类：
  • CoreWebView2.ScriptDialogOpening 事件
• CoreWebView2ScriptDialogOpeningEventArgs 类

WinRT/C#

• CoreWebView2 类：
  • CoreWebView2.ScriptDialogOpening 事件
• CoreWebView2ScriptDialogOpeningEventArgs 类

Win32/C++

• ICoreWebView2 接口：
  • ICoreWebView2：：add_ScriptDialogOpening 方法
  • ICoreWebView2：：remove_ScriptDialogOpening 方法
• ICoreWebView2ScriptDialogOpeningEventArgs 接口

共享缓冲区

SharedBuffer API 支持基于 OS 中的共享内存在 WebView2 主机应用进程和 WebView2 呈现器进程之间共享缓冲区。

.NET/C#

• CoreWebView2 类：
  • CoreWebView2.PostSharedBufferToScript 方法
• CoreWebView2Environment 类：
  • ICoreWebView2Environment.CreateSharedBuffer 方法
• CoreWebView2Frame 类：
  • CoreWebView2Frame.PostSharedBufferToScript 方法
• CoreWebView2SharedBuffer 类
  • CoreWebView2SharedBuffer.Buffer 属性
  • CoreWebView2SharedBuffer.FileMappingHandle 属性
  • CoreWebView2SharedBuffer.Size 属性
  • CoreWebView2SharedBuffer.Close 方法
  • CoreWebView2SharedBuffer.Dispose 方法
  • CoreWebView2SharedBuffer.OpenStream 方法
• CoreWebView2SharedBufferAccess 枚举
  • ReadOnly
  • ReadWrite

WinRT/C#

• CoreWebView2 类：
  • CoreWebView2.PostSharedBufferToScript 方法
• CoreWebView2Environment 类：
  • ICoreWebView2Environment.CreateSharedBuffer 方法
• CoreWebView2Frame 类：
  • CoreWebView2Frame.PostSharedBufferToScript 方法
• CoreWebView2SharedBuffer 类
  • CoreWebView2SharedBuffer.Buffer 属性
  • CoreWebView2SharedBuffer.Size 属性
  • CoreWebView2SharedBuffer.Close 方法
  • CoreWebView2SharedBuffer.OpenStream 方法
• CoreWebView2SharedBufferAccess 枚举
  • ReadOnly
  • ReadWrite

Win32/C++

• ICoreWebView2_17 接口：
  • ICoreWebView2_17：:P ostSharedBufferToScript 方法
• ICoreWebView2Environment12 接口：
  • ICoreWebView2Environment12：：CreateSharedBuffer 方法
• ICoreWebView2Frame4 接口：
  • ICoreWebView2Frame4：:P ostSharedBufferToScript 方法
• ICoreWebView2SharedBuffer 接口
  • ICoreWebView2SharedBuffer：：OpenStream 方法
  • ICoreWebView2SharedBuffer：：Close 方法
  • ICoreWebView2SharedBuffer：：get_Size 方法
  • ICoreWebView2SharedBuffer：：get_Buffer 方法
  • ICoreWebView2SharedBuffer：：get_FileMappingHandle 方法
• COREWEBVIEW2_SHARED_BUFFER_ACCESS
  • COREWEBVIEW2_SHARED_BUFFER_ACCESS_READ_ONLY
  • COREWEBVIEW2_SHARED_BUFFER_ACCESS_READ_WRITE

浏览器功能

WebView2 控件允许应用访问许多浏览器功能。 可以修改这些浏览器功能并打开或关闭它们。

以下小节：

• 打印
• Cookie
• 图像捕获
• 下载内容
• 权限
• 上下文菜单
• 状态栏
• 用户代理
• 自动填充
• 音频
• 区域中鼠标单击的命中测试
• 轻扫手势导航
• 启用或禁用浏览器响应快捷键 (快捷键)
• 全屏
• PDF 工具栏
• 主题
• 语言
• 新建窗口
• 关闭窗口
• 文档标题
• Favicon
• 安全和隐私
  • 跟踪防护
  • SmartScreen
  • 自定义崩溃报告

打印

可以通过配置自定义打印设置，将网页打印到打印机、PDF 文件或 PDF 流。

另请参阅：

• 从 WebView2 应用打印

.NET/C#

• CoreWebView2 类：
  • CoreWebView2.ShowPrintUI 方法
  • CoreWebView2.PrintAsync 方法
  • CoreWebView2.PrintToPdfAsync 方法
  • CoreWebView2.PrintToPdfStreamAsync 方法
• CoreWebView2Environment 类：
  • CoreWebView2Environment.CreatePrintSettings 方法
• CoreWebView2PrintSettings 类
• CoreWebView2PrintDialogKind 枚举
• CoreWebView2PrintStatus 枚举

WinRT/C#

• CoreWebView2 类：
  • CoreWebView2.ShowPrintUI 方法
  • CoreWebView2.PrintAsync 方法
  • CoreWebView2.PrintToPdfAsync 方法
  • CoreWebView2.PrintToPdfStreamAsync 方法
• CoreWebView2Environment 类：
  • CoreWebView2Environment.CreatePrintSettings 方法
• CoreWebView2PrintSettings 类
• CoreWebView2PrintDialogKind 枚举
• CoreWebView2PrintStatus 枚举

Win32/C++

• ICoreWebView2_7 接口：
  • ICoreWebView2_7：:P rintToPdf 方法
• ICoreWebView2_16 接口：
  • ICoreWebView2_16：：ShowPrintUI 方法
  • ICoreWebView2_16：:P rint 方法
  • ICoreWebView2_16：:P rintToPdfStream 方法
• ICoreWebView2Environment6 接口：
  • ICoreWebView2Environment6：：CreatePrintSettings 方法
• ICoreWebView2PrintCompletedHandler 接口
• ICoreWebView2PrintSettings 接口
• ICoreWebView2PrintSettings2 接口
• ICoreWebView2PrintToPdfCompletedHandler 接口
• ICoreWebView2PrintToPdfStreamCompletedHandler 接口
• COREWEBVIEW2_PRINT_DIALOG_KIND枚举
• COREWEBVIEW2_PRINT_STATUS枚举

Cookie

可以使用 WebView2 中的 Cookie 来管理用户会话、存储用户个性化首选项以及跟踪用户行为。

另请参阅：

• 查看、编辑和删除 Cookie

.NET/C#

• CoreWebView2 类：
  • CoreWebView2.CookieManager 属性
• CoreWebView2Cookie 类
• CoreWebView2CookieManager 类
• CoreWebView2Profile 类：
  • CoreWebView2Profile.CookieManager 属性

WinRT/C#

• CoreWebView2 类：
  • CoreWebView2.CookieManager 属性
• CoreWebView2Cookie 类
• CoreWebView2CookieManager 类
• CoreWebView2Profile 类：
  • CoreWebView2Profile.CookieManager 属性

Win32/C++

• ICoreWebView2_2 接口：
  • ICoreWebView2_2.get_CookieManager 方法
• ICoreWebView2Cookie 接口
• ICoreWebView2CookieList 接口
• ICoreWebView2CookieManager 接口
• ICoreWebView2Profile5 接口：
  • ICoreWebView2Profile5：：get_CookieManager

图像捕获

通过托管 WebView2，应用可以捕获屏幕截图并指示保存图像的格式。

.NET/C#

• CoreWebView2 类：
  • CoreWebView2.CapturePreviewAsync 方法

WinRT/C#

• CoreWebView2 类：
  • CoreWebView2.CapturePreviewAsync 方法

Win32/C++

• ICoreWebView2 接口：
  • ICoreWebView2.CapturePreview 方法

下载内容

你的应用可以在 WebView2 中管理下载体验。 你的应用可以：

• 基于不同的元数据允许或阻止下载。
• 更改下载位置。
• 配置自定义下载 UI。
• 自定义默认 UI。

.NET/C#

一般：

• CoreWebView2 类：
  • CoreWebView2.IsDefaultDownloadDialogOpenChanged 事件
  • CoreWebView2.IsDefaultDownloadDialogOpen 属性
  • CoreWebView2.OpenDefaultDownloadDialog 方法
  • CoreWebView2.CloseDefaultDownloadDialog 方法

修改默认体验：

• CoreWebView2 类：
  • CoreWebView2.DefaultDownloadDialogCornerAlignment 属性
  • CoreWebView2.DefaultDownloadDialogMargin 属性
• CoreWebView2Profile 类：
  • CoreWebView2Profile.DefaultDownloadFolderPath 属性

自定义下载体验：

• CoreWebView2 类：
  • CoreWebView2.DownloadStarting 事件
• CoreWebView2DownloadStartingEventArgs 类
• CoreWebView2DownloadOperation 类

WinRT/C#

一般：

• CoreWebView2 类：
  • CoreWebView2.IsDefaultDownloadDialogOpenChanged 事件
  • CoreWebView2.IsDefaultDownloadDialogOpen 属性
  • CoreWebView2.OpenDefaultDownloadDialog 方法
  • CoreWebView2.CloseDefaultDownloadDialog 方法

修改默认体验：

• CoreWebView2 类：
  • CoreWebView2.DefaultDownloadDialogCornerAlignment 属性
  • CoreWebView2.DefaultDownloadDialogMargin 属性
• CoreWebView2Profile 类：
  • CoreWebView2Profile.DefaultDownloadFolderPath 属性

自定义下载体验：

• CoreWebView2 类：
  • CoreWebView2.DownloadStarting 事件
• CoreWebView2DownloadStartingEventArgs 类
• CoreWebView2DownloadOperation 类

Win32/C++

一般：

• ICoreWebView2_9 接口：
  • ICoreWebView2_9：：get_IsDefaultDownloadDialogOpen 方法
  • ICoreWebView2_9：：OpenDefaultDownloadDialog 方法
  • ICoreWebView2_9：：add_IsDefaultDownloadDialogOpenChanged 方法
  • ICoreWebView2_9：：remove_IsDefaultDownloadDialogOpenChanged 方法
  • ICoreWebView2_9：：CloseDefaultDownloadDialog 方法

修改默认体验：

• ICoreWebView2_9 接口：
  • ICoreWebView2_9：：get_DefaultDownloadDialogCornerAlignment 方法
  • ICoreWebView2_9：:p ut_DefaultDownloadDialogCornerAlignment 方法
  • ICoreWebView2_9：：get_DefaultDownloadDialogMargin 方法
  • ICoreWebView2_9：:p ut_DefaultDownloadDialogMargin 方法
• ICoreWebView2Profile 接口：
  • ICoreWebView2Profile：：get_DefaultDownloadFolderPath 方法
  • ICoreWebView2Profile：:p ut_DefaultDownloadFolderPath 方法

自定义下载体验：

• ICoreWebView2_4 接口：
  • ICoreWebView2_4：：add_DownloadStarting 方法
  • ICoreWebView2_4：：remove_DownloadStarting 方法
• ICoreWebView2DownloadStartingEventArgs 接口
• ICoreWebView2DownloadOperation 接口

权限

不同的网页可能会要求你提供访问某些特权资源（例如地理位置传感器、相机和麦克风）的权限。 主机应用可以编程方式响应权限请求，并且可以将默认权限 UI 替换为自己的 UI。

.NET/C#

• CoreWebView2 类：
  • CoreWebView2.PermissionRequested 事件
• CoreWebView2Frame 类：
  • CoreWebView2Frame.PermissionRequested 事件
• CoreWebView2PermissionKind 枚举
• CoreWebView2PermissionRequestedEventArgs 类：
  • CoreWebView2PermissionRequestedEventArgs.SavesInProfile 属性
• CoreWebView2PermissionSetting 类
  • CoreWebView2PermissionSetting.PermissionKind 属性
  • CoreWebView2PermissionSetting.PermissionOrigin 属性
  • CoreWebView2PermissionSetting.PermissionState 属性
• CoreWebView2Profile 类：
  • CoreWebView2Profile.GetNonDefaultPermissionSettingsAsync 方法
  • CoreWebView2Profile.SetPermissionStateAsync 方法

WinRT/C#

• CoreWebView2 类：
  • CoreWebView2.PermissionRequested 事件
• CoreWebView2Frame 类：
  • CoreWebView2Frame.PermissionRequested 事件
• CoreWebView2PermissionKind 枚举
• CoreWebView2PermissionRequestedEventArgs 类：
  • CoreWebView2PermissionRequestedEventArgs.SavesInProfile 属性
• CoreWebView2PermissionSetting 类
  • CoreWebView2PermissionSetting.PermissionKind 属性
  • CoreWebView2PermissionSetting.PermissionOrigin 属性
  • CoreWebView2PermissionSetting.PermissionState 属性
• CoreWebView2Profile 类：
  • CoreWebView2Profile.GetNonDefaultPermissionSettingsAsync 方法
  • CoreWebView2Profile.SetPermissionStateAsync 方法

Win32/C++

• ICoreWebView2 接口：
  • ICoreWebView2：：add_PermissionRequested
  • ICoreWebView2：：remove_PermissionRequested
• ICoreWebView2GetNonDefaultPermissionSettingsCompletedHandler 接口
• ICoreWebView2Frame3 接口：
  • ICoreWebView2Frame3：：add_PermissionRequested
  • ICoreWebView2Frame3：：remove_PermissionRequested
• ICoreWebView2PermissionRequestedEventArgs 接口
• ICoreWebView2PermissionRequestedEventArgs3 接口：
  • ICoreWebView2PermissionRequestedEventArgs3：：get_SavesInProfile
  • ICoreWebView2PermissionRequestedEventArgs3：:p ut_SavesInProfile
• ICoreWebView2PermissionSetting 接口
  • ICoreWebView2PermissionSetting：：get_PermissionKind 方法
  • ICoreWebView2PermissionSetting：：get_PermissionOrigin 方法
  • ICoreWebView2PermissionSetting：：get_PermissionState 方法
• ICoreWebView2PermissionSettingCollectionView 接口
  • ICoreWebView2PermissionSettingCollectionView：：GetValueAtIndex 方法
  • ICoreWebView2PermissionSettingCollectionView：：get_Count 方法
• ICoreWebView2Profile4 接口：
  • ICoreWebView2Profile4：：GetNonDefaultPermissionSettings 方法
  • ICoreWebView2Profile4：：SetPermissionState 方法
• ICoreWebView2SetPermissionStateCompletedHandler 接口
• COREWEBVIEW2_PERMISSION_KIND枚举

上下文菜单

WebView2 控件提供默认上下文菜单 (右键单击菜单) ，你可以自定义或禁用该菜单，还可以创建自己的上下文菜单。

另请参阅：

• 在 WebView2 中自定义上下文菜单

.NET/C#

• CoreWebView2 类：
  • CoreWebView2.ContextMenuRequested 事件
• CoreWebView2ContextMenuItem 类
• CoreWebView2ContextMenuRequestedEventArgs 类
• CoreWebView2ContextMenuTarget 类
• CoreWebView2Environment 类：
  • CoreWebView2Environment.CreateContextMenuItem 方法
• CoreWebView2Settings 类：
  • CoreWebView2Settings.AreDefaultContextMenusEnabled 属性

WinRT/C#

• CoreWebView2 类：
  • CoreWebView2.ContextMenuRequested 事件
• CoreWebView2ContextMenuItem 类
• CoreWebView2ContextMenuRequestedEventArgs 类
• CoreWebView2ContextMenuTarget 类
• CoreWebView2Environment 类：
  • CoreWebView2Environment.CreateContextMenuItem 方法
• CoreWebView2Settings 类：
  • CoreWebView2Settings.AreDefaultContextMenusEnabled 属性

Win32/C++

• ICoreWebView2_11 接口：
  • ICoreWebView2_11：：add_ContextMenuRequested
  • ICoreWebView2_11：：remove_ContextMenuRequested
• ICoreWebView2ContextMenuRequestedEventArgs 接口
• ICoreWebView2ContextMenuItem 接口
• ICoreWebView2ContextMenuItemCollection 接口
• ICoreWebView2ContextMenuTarget 接口
• ICoreWebView2Environment9 接口：
  • ICoreWebView2Environment9：：CreateContextMenuItem 方法
• ICoreWebView2Settings 接口：
  • ICoreWebView2Settings：：get_AreDefaultContextMenusEnabled 方法
  • ICoreWebView2Settings：:p ut_AreDefaultContextMenusEnabled 方法

状态栏

状态栏位于页面的左下角，显示正在显示的网页的状态。 在 WebView2 中，可以启用/禁用状态栏、获取状态栏中的文本，并找出状态栏文本何时更改。

.NET/C#

• CoreWebView2 类：
  • CoreWebView2.StatusBarText 属性
  • CoreWebView2.StatusBarTextChanged 事件
• CoreWebView2Settings 类：
  • CoreWebView2Settings.IsStatusBarEnabled 属性

WinRT/C#

• CoreWebView2 类：
  • CoreWebView2.StatusBarText 属性
  • CoreWebView2.StatusBarTextChanged 事件
• CoreWebView2Settings 类：
  • CoreWebView2Settings.IsStatusBarEnabled 属性

Win32/C++

• ICoreWebView2_12 接口：
  • ICoreWebView2_12：：add_StatusBarTextChanged
  • ICoreWebView2_12：：get_StatusBarText
  • ICoreWebView2_12：：remove_StatusBarTextChanged
• ICoreWebView2Settings 接口：
  • ICoreWebView2Settings：：get_IsStatusBarEnabled
  • ICoreWebView2Settings：:p ut_IsStatusBarEnabled

用户代理

用户代理是一个字符串，代表用户表示程序的标识，例如浏览器名称。 在 WebView2 中，可以设置用户代理。

另请参阅：

• 使用 User-Agent 客户端提示检测Windows 11
• 重写用户代理字符串

.NET/C#

• CoreWebView2Settings 类：
  • CoreWebView2Settings.UserAgent 属性

WinRT/C#

• CoreWebView2Settings 类：
  • CoreWebView2Settings.UserAgent 属性

Win32/C++

• ICoreWebView2Settings2 类
  • ICoreWebView2Settings2：：get_UserAgent
  • ICoreWebView2Settings2：:p ut_UserAgent

自动填充

应用可以独立控制是否为常规信息或密码启用浏览器的自动填充功能。

.NET/C#

• CoreWebView2Settings 类：
  • CoreWebView2Settings.IsGeneralAutofillEnabled 属性
  • CoreWebView2Settings.IsPasswordAutosaveEnabled 属性

WinRT/C#

• CoreWebView2Settings 类：
  • CoreWebView2Settings.IsGeneralAutofillEnabled 属性
  • CoreWebView2Settings.IsPasswordAutosaveEnabled 属性

Win32/C++

• ICoreWebView2Settings4 接口：
  • ICoreWebView2Settings4：：get_IsGeneralAutofillEnabled 方法
  • ICoreWebView2Settings4：：get_IsPasswordAutosaveEnabled 方法
  • ICoreWebView2Settings4：:p ut_IsGeneralAutofillEnabled 方法
  • ICoreWebView2Settings4：:p ut_IsPasswordAutosaveEnabled 方法

音频

你的应用可以将所有音频静音和取消静音，并找出何时播放音频。

.NET/C#

• CoreWebView2 类：
  • CoreWebView2.IsDocumentPlayingAudioChanged 事件
  • CoreWebView2.IsMutedChanged 事件
  • CoreWebView2.IsDocumentPlayingAudio 属性
  • CoreWebView2.IsMuted 属性

WinRT/C#

• CoreWebView2 类：
  • CoreWebView2.IsDocumentPlayingAudioChanged 事件
  • CoreWebView2.IsMutedChanged 事件
  • CoreWebView2.IsDocumentPlayingAudio 属性
  • CoreWebView2.IsMuted 属性

Win32/C++

• ICoreWebView2_8 接口：
  • ICoreWebView2_8：：add_IsDocumentPlayingAudioChanged 方法
  • ICoreWebView2_8：：add_IsMutedChanged 方法
  • ICoreWebView2_8：：get_IsDocumentPlayingAudio 方法
  • ICoreWebView2_8：：get_IsMuted 方法
  • ICoreWebView2_8：:p ut_IsMuted 方法
  • ICoreWebView2_8：：remove_IsDocumentPlayingAudioChanged 方法
  • ICoreWebView2_8：：remove_IsMutedChanged 方法

区域中鼠标单击的命中测试

针对 WebView2 包含的区域提供命中测试结果。 对于想要在 WebView2 窗口的非工作区上处理鼠标事件的可视托管应用程序非常有用。

.NET/C#

• CoreWebView2CompositionController 类：

  • CoreWebView2CompositionController.GetNonClientRegionAtPoint 方法
  • CoreWebView2CompositionController.NonClientRegionChanged 事件
  • CoreWebView2CompositionController.QueryNonClientRegion 方法

• CoreWebView2NonClientRegionChangedEventArgs 类：

  • CoreWebView2NonClientRegionChangedEventArgs.RegionKind 属性

• CoreWebView2NonClientRegionKind 枚举

  • Caption
  • Client
  • Nowhere

• CoreWebView2Settings 类：

  • CoreWebView2Settings.IsNonClientRegionSupportEnabled 属性

WinRT/C#

• CoreWebView2CompositionController 类：

  • CoreWebView2CompositionController.GetNonClientRegionAtPoint 属性
  • CoreWebView2CompositionController.NonClientRegionChanged 事件
  • CoreWebView2CompositionController.QueryNonClientRegion 属性

• CoreWebView2NonClientRegionChangedEventArgs 类：

  • CoreWebView2NonClientRegionChangedEventArgs.RegionKind 属性

• CoreWebView2NonClientRegionKind 枚举

  • Caption
  • Client
  • Nowhere

• CoreWebView2Settings 类：

  • CoreWebView2Settings.IsNonClientRegionSupportEnabled 属性

Win32/C++

• ICoreWebView2CompositionController4

  • ICoreWebView2CompositionController4：：add_NonClientRegionChanged
  • ICoreWebView2CompositionController4：：GetNonClientRegionAtPoint
  • ICoreWebView2CompositionController4：：QueryNonClientRegion
  • ICoreWebView2CompositionController4：：remove_NonClientRegionChanged

• ICoreWebView2NonClientRegionChangedEventArgs

  • ICoreWebView2NonClientRegionChangedEventArgs：：get_RegionKind

• ICoreWebView2NonClientRegionChangedEventHandler

• ICoreWebView2RegionRectCollectionView

• ICoreWebView2Settings9

  • ICoreWebView2Settings9：：get_IsNonClientRegionSupportEnabled
  • ICoreWebView2Settings9：:p ut_IsNonClientRegionSupportEnabled

• COREWEBVIEW2_NON_CLIENT_REGION_KIND枚举

  • COREWEBVIEW2_NON_CLIENT_REGION_KIND_CAPTION
  • COREWEBVIEW2_NON_CLIENT_REGION_KIND_CLIENT
  • COREWEBVIEW2_NON_CLIENT_REGION_KIND_NOWHERE

轻扫手势导航

通过托管 WebView2 控件，你的应用可以在启用触摸输入的设备上启用或禁用轻扫手势导航。 此手势允许最终用户：

• 向左/向右轻扫 (水平轻扫) 导航到导航历史记录中的上一页或下一页。
• 拉取以刷新 () 当前页垂直轻扫。

默认情况下，此功能在浏览器中处于禁用状态。 若要在 WebView2 中启用此功能，请设置 AdditionalBrowserArguments 属性并指定 --pull-to-refresh 开关。

.NET/C#

• CoreWebView2Settings 类：
  • CoreWebView2Settings.IsSwipeNavigationEnabled 属性
• CoreWebView2EnvironmentOptions 类：
  • CoreWebView2EnvironmentOptions.AdditionalBrowserArguments 属性

WinRT/C#

• CoreWebView2Settings 类：
  • CoreWebView2Settings.IsSwipeNavigationEnabled 属性
• CoreWebView2EnvironmentOptions 类：
  • CoreWebView2EnvironmentOptions.AdditionalBrowserArguments 属性

Win32/C++

• ICoreWebView2Settings6 接口：
  • ICoreWebView2Settings6：：get_IsSwipeNavigationEnabled 方法
  • ICoreWebView2Settings6：:p ut_IsSwipeNavigationEnabled 方法
• ICoreWebView2EnvironmentOptions 接口：
  • ICoreWebView2EnvironmentOptions：：get_AdditionalBrowserArguments 方法
  • ICoreWebView2EnvironmentOptions：:p ut_AdditionalBrowserArguments 方法

启用或禁用浏览器响应快捷键 (快捷键)

ICoreWebView2AcceleratorKeyPressedEventArgs 具有 属性 IsBrowserAcceleratorKeyEnabled ，用于控制浏览器是否处理快捷键 (快捷键) ，例如 Ctrl+P 或 F3。

另请参阅：

• 键盘快捷键，如下所示。

.NET/C#

• CoreWebView2AcceleratorKeyPressedEventArgs 类：
  • CoreWebView2AcceleratorKeyPressedEventArgs.IsBrowserAcceleratorKeyEnabled 属性

WinRT/C#

• CoreWebView2AcceleratorKeyPressedEventArgs 类：
  • CoreWebView2AcceleratorKeyPressedEventArgs.IsBrowserAcceleratorKeyEnabled 属性

Win32/C++

• ICoreWebView2AcceleratorKeyPressedEventArgs2
  • ICoreWebView2AcceleratorKeyPressedEventArgs2：：get_IsBrowserAcceleratorKeyEnabled
  • ICoreWebView2AcceleratorKeyPressedEventArgs2：:p ut_IsBrowserAcceleratorKeyEnabled

全屏

在 WebView2 中，可以了解 HTML 元素何时进入或离开全屏视图。

.NET/C#

• CoreWebView2 类：
  • CoreWebView2.ContainsFullScreenElement 属性
  • CoreWebView2.ContainsFullScreenElementChanged 事件

WinRT/C#

• CoreWebView2 类：
  • CoreWebView2.ContainsFullScreenElement 属性
  • CoreWebView2.ContainsFullScreenElementChanged 事件

Win32/C++

• ICoreWebView2 接口：
  • ICoreWebView2：：get_ContainsFullScreenElement 方法
  • ICoreWebView2：：add_ContainsFullScreenElementChanged 方法
  • ICoreWebView2：：remove_ContainsFullScreenElementChanged 方法

PDF 工具栏

在浏览器 PDF 查看器中，顶部有一个特定于 PDF 的工具栏。 在 WebView2 中，可以隐藏 PDF 查看器工具栏中的某些项。

.NET/C#

• CoreWebView2Settings 类：
  • CoreWebView2Settings.HiddenPdfToolbarItems 属性

WinRT/C#

• CoreWebView2Settings 类：
  • CoreWebView2Settings.HiddenPdfToolbarItems 属性

Win32/C++

• ICoreWebView2Settings7 接口：
  • ICoreWebView2Settings7：：get_HiddenPdfToolbarItems 方法
  • ICoreWebView2Settings7：:p ut_HiddenPdfToolbarItems 方法

主题

在 WebView2 中，可以将颜色主题自定义为系统、浅色或深色。

.NET/C#

• CoreWebView2Profile 类：
  • CoreWebView2Profile.PreferredColorScheme 属性

WinRT/C#

• CoreWebView2Profile 类：
  • CoreWebView2Profile.PreferredColorScheme 属性

Win32/C++

• ICoreWebView2Profile 接口：
  • ICoreWebView2Profile：：get_PreferredColorScheme 方法
  • ICoreWebView2Profile：:p ut_PreferredColorScheme 方法

语言

属性 Language 设置 WebView2 的默认显示语言，该语言适用于浏览器 UI (（例如上下文菜单和) 对话框），同时设置 accept-language WebView2 发送到网站的 HTTP 标头。

属性 ScriptLocale 允许主机应用为所有 Intl JavaScript API 和依赖它的其他 JavaScript API 设置默认区域设置，例如 Intl.DateTimeFormat()，这会影响时间/日期格式的字符串格式。

.NET/C#

• CoreWebView2EnvironmentOptions 类：
  • CoreWebView2EnvironmentOptions.Language 属性
• CoreWebView2ControllerOptions 类：
  • CoreWebView2ControllerOptions.ScriptLocale 属性

WinRT/C#

• CoreWebView2EnvironmentOptions 类：
  • CoreWebView2EnvironmentOptions.Language 属性
• CoreWebView2ControllerOptions 类：
  • CoreWebView2ControllerOptions.ScriptLocale 属性

Win32/C++

• ICoreWebView2EnvironmentOptions 接口：
  • ICoreWebView2EnvironmentOptions：：get_Language 方法
  • ICoreWebView2EnvironmentOptions：:p ut_Language 方法
• ICoreWebView2ControllerOptions2 接口：
  • ICoreWebView2ControllerOptions2：：get_ScriptLocale 方法
  • ICoreWebView2ControllerOptions2：:p ut_ScriptLocale 方法

新建窗口

WebView2 提供处理 JavaScript 函数 window.open()的功能。

.NET/C#

• CoreWebView2 类：
  • CoreWebView2.NewWindowRequested 事件
• CoreWebView2NewWindowRequestedEventArgs 类
• CoreWebView2WindowFeatures 类

WinRT/C#

• CoreWebView2 类：
  • CoreWebView2.NewWindowRequested 事件
• CoreWebView2NewWindowRequestedEventArgs 类
• CoreWebView2WindowFeatures 类

Win32/C++

• ICoreWebView2 接口：
  • ICoreWebView2：：add_NewWindowRequested 方法
  • ICoreWebView2：：remove_NewWindowRequested 方法
• ICoreWebView2NewWindowRequestedEventArgs 接口
• ICoreWebView2WindowFeatures 接口

关闭窗口

WebView2 提供处理 JavaScript 函数 window.close()的功能。

.NET/C#

• CoreWebView2 类：
  • CoreWebView2.WindowCloseRequested 事件
• CoreWebView2Controller 类：
  • CoreWebView2Controller.Close 方法

WinRT/C#

• CoreWebView2 类：
  • CoreWebView2.WindowCloseRequested 事件
• CoreWebView2Controller 类：
  • CoreWebView2Controller.Close 方法

Win32/C++

• ICoreWebView2 接口：
  • ICoreWebView2：：add_WindowCloseRequested 方法
  • ICoreWebView2：：remove_WindowCloseRequested 方法
• ICoreWebView2Controller 接口：
  • ICoreWebView2Controller：：Close 方法

文档标题

应用可以检测当前顶级文档的标题何时发生更改。

.NET/C#

• CoreWebView2 类：
  • CoreWebView2.DocumentTitle 属性
  • CoreWebView2.DocumentTitleChanged 事件

WinRT/C#

• CoreWebView2 类：
  • CoreWebView2.DocumentTitle 属性
  • CoreWebView2.DocumentTitleChanged 事件

Win32/C++

• ICoreWebView2 接口：
  • ICoreWebView2：：get_DocumentTitle 方法
  • ICoreWebView2：：add_DocumentTitleChanged 方法
  • ICoreWebView2：：remove_DocumentTitleChanged 方法

Favicon

在 WebView2 中，可以为网站设置 Favicon ，或者在网站更改时收到通知。

.NET/C#

• CoreWebView2 类：
  • CoreWebView2.FaviconChanged 事件
  • CoreWebView2.FaviconUri 属性

WinRT/C#

• CoreWebView2 类：
  • CoreWebView2.FaviconChanged 事件
  • CoreWebView2.FaviconUri 属性

Win32/C++

• ICoreWebView2_15 接口：
  • ICoreWebView2_15：：add_FaviconChanged 方法
  • ICoreWebView2_15：：remove_FaviconChanged 方法
  • ICoreWebView2_15：：get_FaviconUri 方法

安全和隐私

跟踪防护

跟踪防护使主机应用能够控制与用户配置文件关联的 WebView2 控件的跟踪防护级别。

.NET/C#

• CoreWebView2EnvironmentOptions 类：
  • CoreWebView2EnvironmentOptions.EnableTrackingPrevention 属性
• CoreWebView2Profile 类：
  • CoreWebView2Profile.PreferredTrackingPreventionLevel 属性
• CoreWebView2TrackingPreventionLevel Enum
  • None
  • Basic
  • Balanced
  • Strict

WinRT/C#

• CoreWebView2EnvironmentOptions 类：
  • CoreWebView2EnvironmentOptions.EnableTrackingPrevention 属性
• CoreWebView2Profile 类：
  • CoreWebView2Profile.PreferredTrackingPreventionLevel 属性
• CoreWebView2TrackingPreventionLevel Enum
  • None
  • Basic
  • Balanced
  • Strict

Win32/C++

• ICoreWebView2EnvironmentOptions5 接口：
  • ICoreWebView2EnvironmentOptions5：：get_EnableTrackingPrevention 方法
  • ICoreWebView2EnvironmentOptions5：:p ut_EnableTrackingPrevention 方法
• ICoreWebView2Profile3 接口：
  • ICoreWebView2Profile3：：get_PreferredTrackingPreventionLevel 方法
  • ICoreWebView2Profile3：:p ut_PreferredTrackingPreventionLevel 方法
• COREWEBVIEW2_TRACKING_PREVENTION_LEVEL枚举
  • COREWEBVIEW2_TRACKING_PREVENTION_LEVEL_NONE
  • COREWEBVIEW2_TRACKING_PREVENTION_LEVEL_BASIC
  • COREWEBVIEW2_TRACKING_PREVENTION_LEVEL_BALANCED
  • COREWEBVIEW2_TRACKING_PREVENTION_LEVEL_STRICT

SmartScreen

Microsoft Defender SmartScreen (“SmartScreen”) 默认处于启用状态。 属性 IsReputationCheckingRequired 控制是否启用 SmartScreen。

如果不禁用 SmartScreen，则必须向所有用户发出通知，说明你的软件包括Microsoft Defender SmartScreen，并收集用户信息并将其发送给 Microsoft，如 Microsoft 隐私声明和 Microsoft Edge 隐私白皮书中所述。

另请参阅：

• WebView2 中的数据和隐私中的SmartScreen。

.NET/C#

• CoreWebView2Settings 类：
  • CoreWebView2Settings.IsReputationCheckingRequired 属性

WinRT/C#

• CoreWebView2Settings 类：
  • CoreWebView2Settings.IsReputationCheckingRequired 属性

Win32/C++

• ICoreWebView2Settings8 接口：
  • ICoreWebView2Settings8：：get_IsReputationCheckingRequired 方法
  • ICoreWebView2Settings8：:p ut_IsReputationCheckingRequired 方法

自定义崩溃报告

如果任何 WebView2 进程崩溃，则会创建一个或多个小型转储文件并将其发送给 Microsoft 进行诊断。 运行诊断并执行分析时，使用此 API 自定义崩溃报告。

• 若要防止故障转储发送到 Microsoft，请将 IsCustomCrashReportingEnabled 属性设置为 false。
• 若要查找故障转储并对其进行自定义，请使用 CrashDumpFolderPath 属性。

另请参阅：

• WebView2 中数据和隐私中的自定义崩溃报告。
• 小型转储文件

.NET/C#

• CoreWebView2EnvironmentOptions 类：
  • CoreWebView2EnvironmentOptions.IsCustomCrashReportingEnabled 属性
• CoreWebView2Environment 类：
  • CoreWebView2Environment.FailureReportFolderPath 属性

WinRT/C#

• CoreWebView2EnvironmentOptions 类：
  • CoreWebView2EnvironmentOptions.IsCustomCrashReportingEnabled 属性
• CoreWebView2Environment 类：
  • CoreWebView2Environment.FailureReportFolderPath 属性

Win32/C++

• ICoreWebView2EnvironmentOptions3 接口：
  • ICoreWebView2EnvironmentOptions3：：get_IsCustomCrashReportingEnabled
• ICoreWebView2Environment11 接口：
  • ICoreWebView2Environment11：：get_FailureReportFolderPath

浏览器扩展

应用可以嵌入 WebView2 控件，该控件使用浏览器扩展 (加载项) 。 Microsoft Edge 扩展 是开发人员用来添加或修改 Microsoft Edge 功能以改进用户的浏览体验的小型应用。

另请参阅：

• Microsoft Edge 扩展概述

.NET/C#

• CoreWebView2BrowserExtension 类

  • CoreWebView2BrowserExtension.Id 属性
  • CoreWebView2BrowserExtension.IsEnabled 属性
  • CoreWebView2BrowserExtension.Name 属性
  • CoreWebView2BrowserExtension.EnableAsync 方法
  • CoreWebView2BrowserExtension.RemoveAsync 方法

• CoreWebView2EnvironmentOptions 类：

  • CoreWebView2EnvironmentOptions.AreBrowserExtensionsEnabled 属性

• CoreWebView2Profile 类：

  • CoreWebView2Profile.AddBrowserExtensionAsync 方法
  • CoreWebView2Profile.GetBrowserExtensionsAsync 方法

WinRT/C#

• CoreWebView2BrowserExtension 类

  • CoreWebView2BrowserExtension.Id 属性
  • CoreWebView2BrowserExtension.IsEnabled 属性
  • CoreWebView2BrowserExtension.Name 属性
  • CoreWebView2BrowserExtension.EnableAsync 方法
  • CoreWebView2BrowserExtension.RemoveAsync 方法

• CoreWebView2EnvironmentOptions 类：

  • CoreWebView2EnvironmentOptions.AreBrowserExtensionsEnabled 属性

• CoreWebView2Profile 类：

  • CoreWebView2Profile.AddBrowserExtensionAsync 方法
  • CoreWebView2Profile.GetBrowserExtensionsAsync 属性

Win32/C++

• ICoreWebView2BrowserExtension

  • ICoreWebView2BrowserExtension：：Enable
  • ICoreWebView2BrowserExtension：：get_Id
  • ICoreWebView2BrowserExtension：：get_IsEnabled
  • ICoreWebView2BrowserExtension：：get_Name
  • ICoreWebView2BrowserExtension：：Remove

• ICoreWebView2BrowserExtensionEnableCompletedHandler

• ICoreWebView2BrowserExtensionRemoveCompletedHandler

• ICoreWebView2BrowserExtensionList

  • ICoreWebView2BrowserExtensionList：：get_Count
  • ICoreWebView2BrowserExtensionList：：GetValueAtIndex

• ICoreWebView2EnvironmentOptions6

  • ICoreWebView2EnvironmentOptions6：：get_AreBrowserExtensionsEnabled
  • ICoreWebView2EnvironmentOptions6：:p ut_AreBrowserExtensionsEnabled

• ICoreWebView2Profile7

  • ICoreWebView2Profile7：：AddBrowserExtension
  • ICoreWebView2Profile7：：GetBrowserExtensions

• ICoreWebView2ProfileAddBrowserExtensionCompletedHandler

• ICoreWebView2ProfileGetBrowserExtensionsCompletedHandler

进程管理

获取有关运行 WebView2 进程、退出进程和失败进程的信息，以便应用可以采取相应的操作。

以下小节：

• 框架进程信息

.NET/C#

• CoreWebView2 类：
  • CoreWebView2.BrowserProcessId 属性
  • CoreWebView2.ProcessFailed 事件
• CoreWebView2BrowserProcessExitedEventArgs 类
• CoreWebView2Environment 类：
  • CoreWebView2Environment.GetProcessInfos 方法
  • CoreWebView2Environment.BrowserProcessExited 事件
  • CoreWebView2Environment.ProcessInfosChanged 事件
• CoreWebView2ProcessFailedEventArgs 类
• CoreWebView2ProcessFailedKind 枚举
• CoreWebView2ProcessFailedReason 枚举
• CoreWebView2ProcessInfo 类

WinRT/C#

• CoreWebView2 类：
  • CoreWebView2.BrowserProcessId 属性
  • CoreWebView2.ProcessFailed 事件
• CoreWebView2BrowserProcessExitedEventArgs 类
• CoreWebView2Environment 类：
  • CoreWebView2Environment.GetProcessInfos 方法
  • CoreWebView2Environment.BrowserProcessExited 事件
  • CoreWebView2Environment.ProcessInfosChanged 事件
• CoreWebView2ProcessFailedEventArgs 类
• CoreWebView2ProcessFailedKind 枚举
• CoreWebView2ProcessFailedReason 枚举
• CoreWebView2ProcessInfo 类

Win32/C++

• ICoreWebView2 接口：
  • ICoreWebView2：：add_ProcessFailed
  • ICoreWebView2：：get_BrowserProcessId
  • ICoreWebView2：：remove_ProcessFailed
• ICoreWebView2BrowserProcessExitedEventArgs
• ICoreWebView2Environment5 接口：
  • ICoreWebView2Environment5：：add_BrowserProcessExited
  • ICoreWebView2Environment5：：remove_BrowserProcessExited
• ICoreWebView2Environment8 接口：
  • ICoreWebView2Environment8：：GetProcessInfos
  • ICoreWebView2Environment8：：add_ProcessInfosChanged
  • ICoreWebView2Environment8：：remove_ProcessInfosChanged
• ICoreWebView2ProcessFailedEventArgs
• ICoreWebView2ProcessFailedEventArgs2
• ICoreWebView2ProcessFailedEventArgs3
• ICoreWebView2ProcessInfo
• ICoreWebView2ProcessInfoCollection
• COREWEBVIEW2_PROCESS_FAILED_KIND枚举
• COREWEBVIEW2_PROCESS_FAILED_REASON 枚举

框架进程信息

帧进程信息 API（包括 GetProcessExtendedInfos）提供在关联呈现器进程中主动运行的所有帧的快照集合。 此 API 使应用能够检测 WebView2 的哪个部分消耗了内存或 CPU 使用率等资源。

.NET/C#

• CoreWebView2Environment 类：

  • CoreWebView2Environment.GetProcessExtendedInfosAsync 方法

• CoreWebView2ProcessExtendedInfo 类：

  • CoreWebView2ProcessExtendedInfo.AssociatedFrameInfos 属性
  • CoreWebView2ProcessExtendedInfo.ProcessInfo 属性

• CoreWebView2 类：

  • CoreWebView2.FrameId 属性

• CoreWebView2Frame 类：

  • CoreWebView2Frame.FrameId 属性

• CoreWebView2FrameInfo 类：

  • CoreWebView2FrameInfo.FrameId 属性
  • CoreWebView2FrameInfo.FrameKind 属性
  • CoreWebView2FrameInfo.ParentFrameInfo 属性

• CoreWebView2FrameKind 枚举

WinRT/C#

• CoreWebView2Environment 类：

  • CoreWebView2Environment.GetProcessExtendedInfosAsync 属性

• CoreWebView2ProcessExtendedInfo 类：

  • CoreWebView2ProcessExtendedInfo.AssociatedFrameInfos 属性
  • CoreWebView2ProcessExtendedInfo.ProcessInfo 属性

• CoreWebView2 类：

  • CoreWebView2.FrameId 属性

• CoreWebView2Frame 类：

  • CoreWebView2Frame.FrameId 属性

• CoreWebView2FrameInfo 类：

  • CoreWebView2FrameInfo.FrameId 属性
  • CoreWebView2FrameInfo.FrameKind 属性
  • CoreWebView2FrameInfo.ParentFrameInfo 属性

• CoreWebView2FrameKind 枚举

Win32/C++

• ICoreWebView2Environment13

  • ICoreWebView2Environment13：：GetProcessExtendedInfos

• ICoreWebView2GetProcessExtendedInfosCompletedHandler

• ICoreWebView2ProcessExtendedInfo

  • ICoreWebView2ProcessExtendedInfo：：get_AssociatedFrameInfos
  • ICoreWebView2ProcessExtendedInfo：：get_ProcessInfo

• ICoreWebView2ProcessExtendedInfoCollection

• ICoreWebView2_20

  • ICoreWebView2_20：：get_FrameId

• ICoreWebView2Frame5

  • ICoreWebView2Frame5：：get_FrameId

• ICoreWebView2FrameInfo2

  • ICoreWebView2FrameInfo2：：get_FrameId
  • ICoreWebView2FrameInfo2：：get_FrameKind
  • ICoreWebView2FrameInfo2：：get_ParentFrameInfo

• COREWEBVIEW2_FRAME_KIND 枚举

导航到页面并管理加载的内容

通过 WebView2 控件，应用可以管理指向网页的导航以及管理网页中加载的内容。

以下小节：

• 管理加载到 WebView2 中的内容
• 导航历史记录
• 导航类型
• 阻止不需要的导航
• 导航事件
• 在 WebView2 中管理网络请求
• 自定义方案注册
• 客户端证书
• 服务器证书
• 启动外部 URI 方案

管理加载到 WebView2 中的内容

这些 API 会将内容加载、停止加载和重新加载到 WebView2。 加载的内容可以是：

• URL 中的内容。
• HTML 字符串。
• 通过虚拟主机名到本地文件夹的本地内容映射。
• 来自构造网络请求的内容。

另请参阅：

• 在 WebView2 应用中处理本地内容

.NET/C#

• CoreWebView2 类：
  • CoreWebView2.ClearVirtualHostNameToFolderMapping 方法
  • CoreWebView2.Navigate 方法
  • CoreWebView2.NavigateToString 方法
  • CoreWebView2.NavigateWithWebResourceRequest 方法
  • CoreWebView2.Reload 方法
  • CoreWebView2.SetVirtualHostNameToFolderMapping 方法
  • CoreWebView2.Stop 方法
  • CoreWebView2.WebResourceRequested 事件
• CoreWebView2Settings 类：
  • CoreWebView2Settings.IsBuiltInErrorPageEnabled 属性

WinRT/C#

• CoreWebView2 类：
  • CoreWebView2.ClearVirtualHostNameToFolderMapping 方法
  • CoreWebView2.Navigate 方法
  • CoreWebView2.NavigateToString 方法
  • CoreWebView2.NavigateWithWebResourceRequest 方法
  • CoreWebView2.Reload 方法
  • CoreWebView2.SetVirtualHostNameToFolderMapping 方法
  • CoreWebView2.Stop 方法
  • CoreWebView2.WebResourceRequested 事件
• CoreWebView2Settings 类：
  • CoreWebView2Settings.IsBuiltInErrorPageEnabled 属性

Win32/C++

• ICoreWebView2 接口：
  • ICoreWebView2：：add_WebResourceRequested 方法
  • ICoreWebView2：：remove_WebResourceRequested 方法
  • ICoreWebView2：：Navigate 方法
  • ICoreWebView2：：NavigateToString 方法
  • ICoreWebView2：：Reload 方法
  • ICoreWebView2：：Stop 方法
• ICoreWebView2_2 接口：
  • ICoreWebView2_2：：NavigateWithWebResourceRequest 方法
• ICoreWebView2_3 接口：
  • ICoreWebView2_3：：ClearVirtualHostNameToFolderMapping 方法
  • ICoreWebView2_3：：SetVirtualHostNameToFolderMapping 方法
• ICoreWebView2Settings 接口：
  • ICoreWebView2Settings：：get_IsBuiltInErrorPageEnabled 方法
  • ICoreWebView2Settings：:p ut_IsBuiltInErrorPageEnabled 方法

导航历史记录

历史记录方法允许在 WebView2 中向后和向前导航，历史记录事件提供有关历史记录和 WebView2 当前源中的更改的信息。

.NET/C#

• CoreWebView2 类：
  • CoreWebView2.CanGoBack 属性
  • CoreWebView2.CanGoForward 属性
  • CoreWebView2.GoBack 方法
  • CoreWebView2.GoForward 方法
  • CoreWebView2.HistoryChanged 事件
  • CoreWebView2.Source 属性
  • CoreWebView2.SourceChanged 事件
• CoreWebView2SourceChangedEventArgs 类

WinRT/C#

• CoreWebView2 类：
  • CoreWebView2.CanGoBack 属性
  • CoreWebView2.CanGoForward 属性
  • CoreWebView2.GoBack 方法
  • CoreWebView2.GoForward 方法
  • CoreWebView2.HistoryChanged 事件
  • CoreWebView2.Source 属性
  • CoreWebView2.SourceChanged 事件
• CoreWebView2SourceChangedEventArgs 类

Win32/C++

• ICoreWebView2 接口：
  • ICoreWebView2：：add_HistoryChanged 方法
  • ICoreWebView2：：add_SourceChanged 方法
  • ICoreWebView2：：get_CanGoBack 方法
  • ICoreWebView2：：get_CanGoForward 方法
  • ICoreWebView2：：get_Source 方法
  • ICoreWebView2：：GoBack 方法
  • ICoreWebView2：：GoForward 方法
  • ICoreWebView2：：remove_HistoryChanged 方法
  • ICoreWebView2：：remove_SourceChanged 方法
• ICoreWebView2SourceChangedEventArgs 接口

导航类型

NavigationKind 获取每个导航的导航类型，例如后退/前进、重载或导航到新文档。

.NET/C#

• CoreWebView2NavigationStartingEventArgs 类：
  • CoreWebView2NavigationStartingEventArgs.NavigationKind 属性
• CoreWebView2NavigationKind 枚举

WinRT/C#

• CoreWebView2NavigationStartingEventArgs 类：
  • CoreWebView2NavigationStartingEventArgs.NavigationKind 属性
• CoreWebView2NavigationKind 枚举

Win32/C++

• ICoreWebView2NavigationStartingEventArgs3 接口
  • ICoreWebView2NavigationStartingEventArgs3：：get_NavigationKind 属性
• COREWEBVIEW2_NAVIGATION_KIND枚举

阻止不需要的导航

事件 NavigationStarting 允许应用取消导航到 WebView2 中的指定 URL，包括帧。

.NET/C#

• CoreWebView2 类：
  • CoreWebView2.NavigationStarting 事件
  • CoreWebView2.FrameNavigationStarting 事件 - 已取代;改用CoreWebView2Frame.NavigationStarting
• CoreWebView2Frame 类：
  • CoreWebView2Frame.NavigationStarting 事件
• CoreWebView2NavigationStartingEventArgs 类

WinRT/C#

• CoreWebView2 类：
  • CoreWebView2.NavigationStarting 事件
  • CoreWebView2.FrameNavigationStarting 事件 - 已取代;改用CoreWebView2Frame.NavigationStarting
• CoreWebView2Frame 类：
  • CoreWebView2Frame.NavigationStarting 事件
• CoreWebView2NavigationStartingEventArgs 类

Win32/C++

• ICoreWebView2 接口：
  • ICoreWebView2：：add_NavigationStarting 方法
  • ICoreWebView2：：remove_NavigationStarting 方法
  • ICoreWebView2：：add_FrameNavigationStarting 方法 - 取代;改用ICoreWebView2Frame.add_NavigationStarting
  • ICoreWebView2：：remove_FrameNavigationStarting 方法 - 取代;改用ICoreWebView2Frame.remove_NavigationStarting
• ICoreWebView2Frame2 接口：
  • ICoreWebView2Frame2：：add_NavigationStarting 方法
  • ICoreWebView2Frame2：：remove_NavigationStarting 方法
• ICoreWebView2NavigationStartingEventArgs2 接口

导航事件

使用 NavigationStarting 和其他导航事件，可以通知应用 WebView2 中的导航状态。 导航是加载新 URL 的过程。

另请参阅：

• WebView2 应用的导航事件

.NET/C#

• CoreWebView2 类：
  • CoreWebView2.ContentLoading 事件
  • CoreWebView2.DOMContentLoaded 事件
  • CoreWebView2.FrameNavigationCompleted 事件 - 被取代;请改用 。CoreWebView2Frame.NavigationCompleted
  • CoreWebView2.NavigationCompleted 事件
• CoreWebView2ContentLoadingEventArgs 类
• CoreWebView2DOMContentLoadedEventArgs 类
• CoreWebView2Frame 类：
  • CoreWebView2Frame.ContentLoading 事件
  • CoreWebView2Frame.DOMContentLoaded 事件
  • CoreWebView2Frame.NavigationCompleted 事件
• CoreWebView2NavigationCompletedEventArgs 类

WinRT/C#

• CoreWebView2 类：
  • CoreWebView2.ContentLoading 事件
  • CoreWebView2.DOMContentLoaded 事件
  • CoreWebView2.FrameNavigationCompleted 事件 - 被取代;请改用 。CoreWebView2Frame.NavigationCompleted
  • CoreWebView2.NavigationCompleted 事件
• CoreWebView2ContentLoadingEventArgs 类
• CoreWebView2DOMContentLoadedEventArgs 类
• CoreWebView2Frame 类：
  • CoreWebView2Frame.ContentLoading 事件
  • CoreWebView2Frame.DOMContentLoaded 事件
  • CoreWebView2Frame.NavigationCompleted 事件
• CoreWebView2NavigationCompletedEventArgs 类

Win32/C++

• ICoreWebView2 接口：
  • ICoreWebView2：：add_ContentLoading 方法
  • ICoreWebView2：：add_FrameNavigationCompleted 方法 - 取代;请改用 。ICoreWebView2Frame::add_NavigationCompleted
  • ICoreWebView2：：add_NavigationCompleted 方法
  • ICoreWebView2：：remove_ContentLoading 方法
  • ICoreWebView2：：remove_FrameNavigationCompleted 方法 - 取代;请改用 。ICoreWebView2Frame::remove_NavigationCompleted
  • ICoreWebView2：：remove_NavigationCompleted 方法
• ICoreWebView2_2 接口：
  • ICoreWebView2_2：：add_DOMContentLoaded 方法
  • ICoreWebView2_2：：remove_DOMContentLoaded 方法
• ICoreWebView2Frame2 接口：
  • ICoreWebView2Frame2：：add_ContentLoading 方法
  • ICoreWebView2Frame2：：add_DOMContentLoaded 方法
  • ICoreWebView2Frame2：：add_NavigationCompleted 方法
  • ICoreWebView2Frame2：：remove_ContentLoading 方法
  • ICoreWebView2Frame2：：remove_DOMContentLoaded 方法
  • ICoreWebView2Frame2：：remove_NavigationCompleted 方法
• ICoreWebView2ContentLoadingEventArgs 接口
• ICoreWebView2DOMContentLoadedEventArgs 接口
• ICoreWebView2NavigationCompletedEventArgs 接口
• ICoreWebView2NavigationCompletedEventArgs2 接口

在 WebView2 中管理网络请求

事件 WebResourceRequested 允许应用截获并覆盖 WebView2 中的所有网络请求。 事件 WebResourceResponseReceived 允许应用监视发送到的请求以及从网络收到的响应。

另请参阅：

• 网络请求的自定义管理

.NET/C#

• CoreWebView2 类：

  • CoreWebView2.AddWebResourceRequestedFilter 方法
  • CoreWebView2.RemoveWebResourceRequestedFilter 方法
  • CoreWebView2.WebResourceRequested 事件
  • CoreWebView2.WebResourceResponseReceived 事件

• CoreWebView2WebResourceRequestedEventArgs 类

• CoreWebView2WebResourceRequestSourceKinds 枚举

• CoreWebView2WebResourceResponseReceivedEventArgs 类

WinRT/C#

• CoreWebView2 类：

  • CoreWebView2.AddWebResourceRequestedFilter 方法
  • CoreWebView2.RemoveWebResourceRequestedFilter 方法
  • CoreWebView2.WebResourceRequested 事件
  • CoreWebView2.WebResourceResponseReceived 事件

• CoreWebView2WebResourceRequestedEventArgs 类

• CoreWebView2WebResourceRequestSourceKinds 枚举

• CoreWebView2WebResourceResponseReceivedEventArgs 类

Win32/C++

• ICoreWebView2:

  • ICoreWebView2：：add_WebResourceRequested
  • ICoreWebView2：：remove_WebResourceRequested

• ICoreWebView2_2

  • ICoreWebView2_2：：add_WebResourceResponseReceived
  • ICoreWebView2_2：：remove_WebResourceResponseReceived

• ICoreWebView2_22

  • ICoreWebView2_22：：AddWebResourceRequestedFilterWithRequestSourceKinds
  • ICoreWebView2_22：：RemoveWebResourceRequestedFilterWithRequestSourceKinds

• ICoreWebView2WebResourceRequestedEventArgs

• ICoreWebView2WebResourceRequestedEventArgs2

  • ICoreWebView2WebResourceRequestedEventArgs2：：get_RequestedSourceKind

• ICoreWebView2WebResourceResponseReceivedEventArgs

• COREWEBVIEW2_WEB_RESOURCE_REQUEST_SOURCE_KINDS枚举

自定义方案注册

CustomSchemeRegistration允许在 WebView2 中注册自定义方案，以便应用可以处理WebResourceRequested对这些自定义方案 URL 的请求的事件，并将 WebView2 导航到此类 URL。

.NET/C#

• CoreWebView2CustomSchemeRegistration 类
• CoreWebView2EnvironmentOptions 类：
  • CoreWebView2EnvironmentOptions.CustomSchemeRegistrations 属性

WinRT/C#

• CoreWebView2CustomSchemeRegistration 类
• CoreWebView2EnvironmentOptions 类：
  • CoreWebView2EnvironmentOptions.CustomSchemeRegistrations 属性

Win32/C++

• ICoreWebView2CustomSchemeRegistration 接口
• ICoreWebView2EnvironmentOptions4 接口：
  • ICoreWebView2EnvironmentOptions4：：GetCustomSchemeRegistrations 方法
  • ICoreWebView2EnvironmentOptions4：：SetCustomSchemeRegistrations 方法

客户端证书

在 WebView2 中，可以使用客户端证书 API 在应用程序级别选择客户端证书。 此 API 允许你：

• 根据需要向用户显示 UI。
• 替换默认客户端证书对话框提示符。
• 以编程方式查询证书。
• 当 WebView2 向需要客户端证书进行 HTTP 身份验证的 HTTP 服务器发出请求时，从列表中选择一个证书以响应服务器。

.NET/C#

• CoreWebView2 类：
  • CoreWebView2.ClientCertificateRequested 事件
• CoreWebView2ClientCertificate 类
• CoreWebView2ClientCertificateRequestedEventArgs 类

WinRT/C#

• CoreWebView2 类：
  • CoreWebView2.ClientCertificateRequested 事件
• CoreWebView2ClientCertificate 类
• CoreWebView2ClientCertificateRequestedEventArgs 类

Win32/C++

• ICoreWebView2_5 接口：
  • ICoreWebView2_5：：add_ClientCertificateRequested 方法
  • ICoreWebView2_5：：remove_ClientCertificateRequested 方法
• ICoreWebView2ClientCertificate 接口
• ICoreWebView2ClientCertificateCollection 接口
• ICoreWebView2ClientCertificateRequestedEventArgs 接口

服务器证书

在 WebView2 中，可以使用服务器证书 API 在应用程序级别信任服务器的 TLS 证书。 这样，主机应用可以在不提示用户出现 TLS 错误的情况下呈现页面，或者主机应用可以自动取消请求。

.NET/C#

• CoreWebView2 类：
  • CoreWebView2.ServerCertificateErrorDetected 事件
  • CoreWebView2.ClearServerCertificateErrorActionsAsync 方法

WinRT/C#

• CoreWebView2 类：
  • CoreWebView2.ServerCertificateErrorDetected 事件
  • CoreWebView2.ClearServerCertificateErrorActionsAsync 方法

Win32/C++

• ICoreWebView2_14 接口：
  • ICoreWebView2_14：：add_ServerCertificateErrorDetected 方法
  • ICoreWebView2_14：：remove_ServerCertificateErrorDetected 方法
  • ICoreWebView2_14：：ClearServerCertificateErrorActions 方法

启动外部 URI 方案

启动向 OS 注册的 URI 方案。

.NET/C#

• CoreWebView2 类：
  • CoreWebView2.LaunchingExternalUriScheme 事件
• CoreWebView2LaunchingExternalUriSchemeEventArgs 类
  • CoreWebView2LaunchingExternalUriSchemeEventArgs.Cancel 属性
  • CoreWebView2LaunchingExternalUriSchemeEventArgs.InitiatingOrigin 属性
  • CoreWebView2LaunchingExternalUriSchemeEventArgs.IsUserInitiated 属性
  • CoreWebView2LaunchingExternalUriSchemeEventArgs.Uri 属性
  • CoreWebView2LaunchingExternalUriSchemeEventArgs.GetDeferral 方法

WinRT/C#

• CoreWebView2 类：
  • CoreWebView2.LaunchingExternalUriScheme 事件
• CoreWebView2LaunchingExternalUriSchemeEventArgs 类
  • CoreWebView2LaunchingExternalUriSchemeEventArgs.Cancel 属性
  • CoreWebView2LaunchingExternalUriSchemeEventArgs.InitiatingOrigin 属性
  • CoreWebView2LaunchingExternalUriSchemeEventArgs.IsUserInitiated 属性
  • CoreWebView2LaunchingExternalUriSchemeEventArgs.Uri 属性
  • CoreWebView2LaunchingExternalUriSchemeEventArgs.GetDeferral 属性

Win32/C++

• ICoreWebView2_18
  • ICoreWebView2_18：：add_LaunchingExternalUriScheme
  • ICoreWebView2_18：：remove_LaunchingExternalUriScheme
• ICoreWebView2LaunchingExternalUriSchemeEventHandler
• ICoreWebView2LaunchingExternalUriSchemeEventArgs
  • ICoreWebView2LaunchingExternalUriSchemeEventArgs：：get_Cancel
  • ICoreWebView2LaunchingExternalUriSchemeEventArgs：：get_InitiatingOrigin
  • ICoreWebView2LaunchingExternalUriSchemeEventArgs：：get_IsUserInitiated
  • ICoreWebView2LaunchingExternalUriSchemeEventArgs：：get_Uri
  • ICoreWebView2LaunchingExternalUriSchemeEventArgs：：GetDeferral
  • ICoreWebView2LaunchingExternalUriSchemeEventArgs：:p ut_Cancel

iframes

iframes 允许你将其他网页嵌入到自己的网页中。 在 WebView2 中，可以：

• 了解何时创建 iframe。
• 了解 iframe 何时导航。
• 允许绕过 x 帧选项。

另请参阅：

• 主机/Web 对象共享，上图
• 在 WebView2 应用中使用帧

.NET/C#

• CoreWebView2 类：
  • CoreWebView2.FrameCreated 事件
• CoreWebView2Frame 类
• CoreWebView2FrameCreatedEventArgs 类
• CoreWebView2FrameInfo 类

WinRT/C#

• CoreWebView2 类：
  • CoreWebView2.FrameCreated 事件
• CoreWebView2Frame 类
• CoreWebView2FrameCreatedEventArgs 类
• CoreWebView2FrameInfo 类

Win32/C++

• ICoreWebView2_4 接口：
  • ICoreWebView2_4：：add_FrameCreated 方法
  • ICoreWebView2_4：：remove_FrameCreated 方法
• ICoreWebView2Frame 接口
• ICoreWebView2FrameCreatedEventArgs 接口
• ICoreWebView2FrameInfo 接口
• ICoreWebView2FrameInfoCollection 接口
• ICoreWebView2FrameInfoCollectionIterator 接口

身份验证

应用可以使用 WebView2 控件处理基本身份验证。 基本身份验证 是 HTTP 协议的一部分的特定身份验证方法。

另请参阅：

• WebView2 应用的基本身份验证

.NET/C#

• CoreWebView2 类：
  • CoreWebView2.BasicAuthenticationRequested 事件
• CoreWebView2BasicAuthenticationRequestedEventArgs 类
• CoreWebView2BasicAuthenticationResponse 类
• CoreWebView2HttpHeadersCollectionIterator 类
• CoreWebView2HttpRequestHeaders 类
• CoreWebView2HttpResponseHeaders 类

WinRT/C#

• CoreWebView2 类：
  • CoreWebView2.BasicAuthenticationRequested 事件
• CoreWebView2BasicAuthenticationRequestedEventArgs 类
• CoreWebView2BasicAuthenticationResponse 类
• CoreWebView2HttpHeadersCollectionIterator 类
• CoreWebView2HttpRequestHeaders 类
• CoreWebView2HttpResponseHeaders 类

Win32/C++

• ICoreWebView2_10 接口：
  • ICoreWebView2_10：：add_BasicAuthenticationRequested 方法
  • ICoreWebView2_10：：remove_BasicAuthenticationRequested 方法
• ICoreWebView2BasicAuthenticationRequestedEventArgs 接口
• ICoreWebView2BasicAuthenticationResponse 接口
• ICoreWebView2HttpHeadersCollectionIterator 接口
• ICoreWebView2HttpRequestHeaders 接口
• ICoreWebView2HttpResponseHeaders 接口

在非框架应用中呈现 WebView2

如果主机应用不使用 UI 框架，请使用这些 API 设置 WebView2 呈现系统。 此呈现设置控制 WebView2 如何将输出呈现到主机应用中，以及 WebView2 如何处理输入、焦点和辅助功能。

何时使用这些 API

• UI 框架 - 如果为应用使用 UI 框架，则应使用该 UI 框架提供的 WebView2 元素，而不是使用这些 API。

• 没有 UI 框架，也不使用合成 - 如果你没有为应用使用 UI 框架 (例如，如果你直接使用纯 Win32) ，或者如果你的 UI 框架没有 WebView2 元素，则需要在本部分中使用这些 API 创建 CoreWebView2Controller 并呈现到你的应用中。

• 没有 UI 框架，并且使用合成 - 如果你的应用 UI 是使用 DirectComposition 或 Windows.UI.Composition 生成的，则应使用 CoreWebView2CompositionController 而不是使用这些 API;请参阅下面的 使用合成呈现 WebView2。

以下小节：

• 调整大小、定位和可见性
• 缩放
• 光栅化比例
• 焦点和制表符
• 父窗口
• 键盘快捷键
• 默认背景色

.NET/C#

• CoreWebView2Controller 类：
  • CoreWebView2Controller.CoreWebView2 属性
  • CoreWebView2Controller.Close 方法
• CoreWebView2Environment 类：
  • CoreWebView2Environment.CreateCoreWebView2ControllerAsync 方法

WinRT/C#

• CoreWebView2Controller 类：
  • CoreWebView2Controller.CoreWebView2 属性
  • CoreWebView2Controller.Close 方法
• CoreWebView2Environment 类：
  • CoreWebView2Environment.CreateCoreWebView2ControllerAsync 方法

Win32/C++

• ICoreWebView2Controller 接口：
  • ICoreWebView2Controller：：get_CoreWebView2 方法
  • ICoreWebView2Controller：：Close 方法
• CoreWebView2Environment 类：
  • ICoreWebView2Environment：：CreateCoreWebView2Controller 方法

调整大小、定位和可见性

CoreWebView2Controller 采用父 HWND。 属性 Bounds 相对于父 HWND的 WebView2 大小和位置。 可以使用 切换 IsVisibleWebView2 的可见性。

.NET/C#

• CoreWebView2Controller 类：
  • CoreWebView2Controller.Bounds 属性
  • CoreWebView2Controller.IsVisible 属性

WinRT/C#

• CoreWebView2Controller 类：
  • CoreWebView2Controller.Bounds 属性
  • CoreWebView2Controller.IsVisible 属性

Win32/C++

• ICoreWebView2Controller 接口：
  • ICoreWebView2Controller：：get_Bounds 方法
  • ICoreWebView2Controller：:p ut_Bounds 方法
  • ICoreWebView2Controller：：get_IsVisible 方法
  • ICoreWebView2Controller：:p ut_IsVisible 方法

缩放

WebView2 ZoomFactor 用于仅缩放窗口的 Web 内容。 当用户在旋转鼠标滚轮时按 Ctrl 缩放内容时，UI 缩放也会更新。

.NET/C#

• CoreWebView2Controller 类：
  • CoreWebView2Controller.ZoomFactor 属性
  • CoreWebView2Controller.ZoomFactorChanged 事件
  • CoreWebView2Controller.SetBoundsAndZoomFactor 方法
• CoreWebView2Settings 类：
  • CoreWebView2Settings.IsPinchZoomEnabled 属性
  • CoreWebView2Settings.IsZoomControlEnabled 属性

WinRT/C#

• CoreWebView2Controller 类：
  • CoreWebView2Controller.ZoomFactor 属性
  • CoreWebView2Controller.ZoomFactorChanged 事件
  • CoreWebView2Controller.SetBoundsAndZoomFactor 方法
• CoreWebView2Settings 类：
  • CoreWebView2Settings.IsPinchZoomEnabled 属性
  • CoreWebView2Settings.IsZoomControlEnabled 属性

Win32/C++

• ICoreWebView2Controller 接口：
  • ICoreWebView2Controller：：get_ZoomFactor 方法
  • ICoreWebView2Controller：:p ut_ZoomFactor 方法
  • ICoreWebView2Controller：：add_ZoomFactorChanged 方法
  • ICoreWebView2Controller：：remove_ZoomFactorChanged 方法
  • ICoreWebView2Controller：：SetBoundsAndZoomFactor 方法
• ICoreWebView2Settings 接口：
  • ICoreWebView2Settings：：get_IsZoomControlEnabled 方法
  • ICoreWebView2Settings：:p ut_IsZoomControlEnabled 方法
• ICoreWebView2Settings5 接口：
  • ICoreWebView2Settings5：：get_IsPinchZoomEnabled 方法
  • ICoreWebView2Settings5：:p ut_IsPinchZoomEnabled 方法

光栅化比例

RasterizationScale API 可缩放所有 WebView2 UI，包括上下文菜单、工具提示和弹出窗口。 应用可以设置 WebView2 是否应检测监视器比例更改并自动更新 RasterizationScale。 BoundsMode 用于配置是将 Bounds 属性解释为原始像素，还是需要按 RasterizationScale) 缩放的 DIP (。

.NET/C#

• CoreWebView2Controller 类：
  • CoreWebView2Controller.BoundsMode 属性
  • CoreWebView2Controller.RasterizationScale 属性
  • CoreWebview2Controller.RasterizationScaleChanged 事件
  • CoreWebview2Controller.ShouldDetectMonitorScaleChanges 属性

WinRT/C#

• CoreWebView2Controller 类：
  • CoreWebView2Controller.BoundsMode 属性
  • CoreWebView2Controller.RasterizationScale 属性
  • CoreWebview2Controller.RasterizationScaleChanged 事件
  • CoreWebview2Controller.ShouldDetectMonitorScaleChanges 属性

Win32/C++

• ICoreWebView2Controller3 接口：
  • ICoreWebView2Controller3：：add_RasterizationScaleChanged 方法
  • ICoreWebView2Controller3：：get_BoundsMode 方法
  • ICoreWebView2Controller3：：get_RasterizationScale 方法
  • ICoreWebView2Controller3：：get_ShouldDetectMonitorScaleChanges 方法
  • ICoreWebView2Controller3：:p ut_BoundsMode 方法
  • ICoreWebView2Controller3：:p ut_RasterizationScale 方法
  • ICoreWebView2Controller3：:p ut_ShouldDetectMonitorScaleChanges 方法
  • ICoreWebView2Controller3：：remove_RasterizationScaleChanged 方法

焦点和制表符

WebView2 控件引发事件，让应用知道控件何时获得焦点或失去焦点。 对于 tab 键 (按 Tab 键) ，有一个 API 用于将焦点移到 WebView2 中，还有一个 WebView2 用于请求应用恢复焦点的事件。

.NET/C#

• CoreWebview2Controller 类：
  • CoreWebview2Controller.GotFocus 事件
  • CoreWebview2Controller.LostFocus 事件
  • CoreWebview2Controller.MoveFocus 方法
  • CoreWebview2Controller.MoveFocusRequested 事件
• CoreWebView2MoveFocusRequestedEventArgs 类

WinRT/C#

• CoreWebview2Controller 类：
  • CoreWebview2Controller.GotFocus 事件
  • CoreWebview2Controller.LostFocus 事件
  • CoreWebview2Controller.MoveFocus 方法
  • CoreWebview2Controller.MoveFocusRequested 事件
• CoreWebView2MoveFocusRequestedEventArgs 类

Win32/C++

• ICoreWebview2Controller 接口：
  • ICoreWebview2Controller：：add_GotFocus 方法
  • ICoreWebview2Controller：：add_LostFocus 方法
  • ICoreWebview2Controller：：add_MoveFocusRequested 方法
  • ICoreWebview2Controller：：MoveFocus 方法
  • ICoreWebview2Controller：：remove_GotFocus 方法
  • ICoreWebview2Controller：：remove_LostFocus 方法
  • ICoreWebview2Controller：：remove_MoveFocusRequested 方法
• ICoreWebView2MoveFocusRequestedEventArgs 接口

父窗口

WebView2 可以重新绑定到其他父窗口句柄 (HWND) 。 当应用在屏幕上的位置发生更改时，还需要通知 WebView2。

.NET/C#

• CoreWebview2Controller 类：
  • CoreWebview2Controller.NotifyParentWindowPositionChanged 方法
  • CoreWebview2Controller.ParentWindow 属性

WinRT/C#

• CoreWebview2Controller 类：
  • CoreWebview2Controller.NotifyParentWindowPositionChanged 方法
  • CoreWebview2Controller.ParentWindow 属性

Win32/C++

• ICoreWebview2Controller 接口：
  • ICoreWebview2Controller：：get_ParentWindow 方法
  • ICoreWebview2Controller：：NotifyParentWindowPositionChanged 方法
  • ICoreWebview2Controller：:p ut_ParentWindow 方法

键盘快捷键

当 WebView2 具有焦点时，它直接接收来自用户的输入。 应用可能需要截获和处理某些快捷键组合 (快捷键) ，或禁用正常的浏览器快捷键行为。

另请参阅上述 启用或禁用响应快捷键的浏览器 (快捷键) 。

.NET/C#

• CoreWebView2AcceleratorKeyPressedEventArgs 类
• CoreWebView2Controller 类：
  • CoreWebView2Controller.AcceleratorKeyPressed 事件
• CoreWebView2Settings 类：
  • CoreWebView2Settings.AreBrowserAcceleratorKeysEnabled 属性

WinRT/C#

• CoreWebView2AcceleratorKeyPressedEventArgs 类
• CoreWebView2Controller 类：
  • CoreWebView2Controller.AcceleratorKeyPressed 事件
• CoreWebView2Settings 类：
  • CoreWebView2Settings.AreBrowserAcceleratorKeysEnabled 属性

Win32/C++

• ICoreWebView2AcceleratorKeyPressedEventArgs 接口
• ICoreWebView2Controller 接口：
  • ICoreWebView2Controller：：add_AcceleratorKeyPressed 方法
  • ICoreWebView2Controller：：remove_AcceleratorKeyPressed 方法
• ICoreWebView2Settings3 接口：
  • ICoreWebView2Settings3：：get_AreBrowserAcceleratorKeysEnabled 方法
  • ICoreWebView2Settings3：:p ut_AreBrowserAcceleratorKeysEnabled 方法

默认背景色

WebView2 可以指定默认背景色。 该颜色可以是任何不透明颜色，也可以是透明的。 如果 HTML 页面未设置自己的背景色，则将使用此颜色。

.NET/C#

• CoreWebView2Controller 类：
  • CoreWebView2Controller.DefaultBackgroundColor 属性

WinRT/C#

• CoreWebView2Controller 类：
  • CoreWebView2Controller.DefaultBackgroundColor 属性

Win32/C++

• ICoreWebView2Controller2 接口：
  • ICoreWebView2Controller2：：get_DefaultBackgroundColor 方法
  • ICoreWebView2Controller2：:p ut_DefaultBackgroundColor 方法

使用合成呈现 WebView2

对于基于合成的 WebView2 呈现，请使用 CoreWebView2Environment 创建 CoreWebView2CompositionController。 CoreWebView2CompositionController 提供与 相同的 API CoreWebView2Controller，但也包括用于基于合成的呈现的 API。

以下小节：

• 连接到可视化树
• 转发输入
• 拖放
• 辅助功能

.NET/C#

• CoreWebView2CompositionController 类
• CoreWebView2Environment 类：
  • CoreWebView2Environment.CreateCoreWebView2CompositionControllerAsync 方法

WinRT/C#

• CoreWebView2CompositionController 类
• CoreWebView2Environment 类：
  • CoreWebView2Environment.CreateCoreWebView2CompositionControllerAsync 方法

Win32/C++

• ICoreWebView2CompositionController 接口
• ICoreWebView2Environment3 接口：
  • ICoreWebView2Environment3：：CreateCoreWebview2CompositionController 方法

连接到可视化树

WebView2 可以将其合成树连接到 IDCompositionVisual、 IDCompositionTarget 或 Windows::UI::Composition::ContainerVisual。

.NET/C#

• CoreWebView2CompositionController 类：
  • CoreWebView2CompositionController.RootVisualTarget 属性

WinRT/C#

• CoreWebView2CompositionController 类：
  • CoreWebView2CompositionController.RootVisualTarget 属性

Win32/C++

• ICoreWebView2CompositionController 接口：
  • ICoreWebView2CompositionController：：get_RootVisualTarget 方法
  • ICoreWebView2CompositionController：:p ut_RootVisualTarget 方法

转发输入

应用程序接收空间输入 (鼠标、触摸、笔) ，并且必须发送到 WebView2。 WebView2 会通知应用何时应根据鼠标位置更新光标。

.NET/C#

• CoreWebView2CompositionController 类：
  • CoreWebView2CompositionController.Cursor 属性
  • CoreWebView2CompositionController.CursorChanged 事件
  • CoreWebView2CompositionController.SystemCursorId 属性
  • CoreWebView2CompositionController.SendMouseInput 方法
  • CoreWebView2CompositionController.SendPointerInput 方法
• CoreWebView2Environment 类：
  • CoreWebView2Environment.CreateCoreWebView2PointerInfo 方法
• CoreWebView2PointerInfo 类

WinRT/C#

• CoreWebView2CompositionController 类：
  • CoreWebView2CompositionController.Cursor 属性
  • CoreWebView2CompositionController.CursorChanged 事件
  • CoreWebView2CompositionController.SendMouseInput 方法
  • CoreWebView2CompositionController.SendPointerInput 方法
• CoreWebView2Environment 类：
  • CoreWebView2Environment.CreateCoreWebView2PointerInfo 方法
• CoreWebView2PointerInfo 类

Win32/C++

• CoreWebView2CompositionController 接口：
  • ICoreWebView2CompositionController：：get_Cursor 方法
  • ICoreWebView2CompositionController：：add_CursorChanged 方法
  • ICoreWebView2CompositionController：：remove_CursorChanged 方法
  • ICoreWebView2CompositionController：：get_SystemCursorId 方法
  • ICoreWebView2CompositionController：：SendMouseInput 方法
  • ICoreWebView2CompositionController：：SendPointerInput 方法
• ICoreWebView2Environment3 接口：
  • ICoreWebView2Environment3：：CreateCoreWebView2PointerInfo 方法
• ICoreWebView2PointerInfo 接口

拖放

默认情况下，支持从 WebView2 控件拖动到另一个应用程序。 但是，拖 到 WebView2 控件要求当主机应用从系统收到 IDropTarget 事件时，主机应用必须将事件转发到 WebView2 控件。 拖到 WebView2 控件包括完全在 WebView2 控件中的拖放操作。

使用以下 API 将事件从系统转发 IDropTarget 到 WebView2 控件。

.NET/C#

• CoreWebView2CompositionController 类：
  • CoreWebView2CompositionController.DragLeave 方法

WinRT/C#

• CoreWebView2CompositionController 类：
  • CoreWebView2CompositionController.DragLeave 方法
• ICoreWebView2CompositionControllerInterop2 接口
  • ICoreWebView2CompositionControllerInterop2.DragEnter 方法
  • ICoreWebView2CompositionControllerInterop2.DragLeave 方法
  • ICoreWebView2CompositionControllerInterop2.DragOver 方法
  • ICoreWebView2CompositionControllerInterop2.Drop 方法

Win32/C++

• ICoreWebView2CompositionController3 接口：
  • ICoreWebView2CompositionController3：:D ragEnter 方法
  • ICoreWebView2CompositionController3：:D ragLeave 方法
  • ICoreWebView2CompositionController3：:D ragOver 方法
  • ICoreWebView2CompositionController3：:D rop 方法

辅助功能

默认情况下，对于 Win32/C++ 应用，WebView2 将在辅助功能树中显示为父 HWND 的子级。 WebView2 提供 API，以相对于应用程序中的其他元素更好地定位 WebView2 内容。

.NET/C#

不适用。

WinRT/C#

不适用。

Win32/C++

• ICoreWebView2CompositionController2 接口：
  • ICoreWebView2CompositionController2：：get_AutomationProvider 方法
• ICoreWebView2Environment4 接口：
  • ICoreWebView2Environment4：：GetAutomationProviderForWindow 方法

环境选项

以下小节：

• 用户数据
• 运行时选择

用户数据

(UDF) （用户计算机上的文件夹）管理用户数据文件夹。 UDF 包含与主机应用和 WebView2 相关的数据。 WebView2 应用使用用户数据文件夹来存储浏览器数据，例如 Cookie、权限和缓存的资源。

以下小节：

• 多个配置文件
• 删除配置文件

另请参阅：

• 管理用户数据文件夹
• 清除用户数据文件夹中的浏览数据

.NET/C#

• CoreWebView2Environment 类：
  • CoreWebView2Environment.CreateCoreWebView2CompositionControllerAsync 方法
  • CoreWebView2Environment.CreateCoreWebView2ControllerOptions 方法
  • CoreWebView2Environment.CreateCoreWebView2ControllerWithOptions 方法
  • CoreWebView2Environment.UserDataFolder 属性
• CoreWebView2EnvironmentOptions 类：
  • CoreWebView2EnvironmentOptions.ExclusiveUserDataFolderAccess 属性

清除浏览数据：

• CoreWebView2Profile 类：
  • CoreWebView2Profile.ClearBrowsingDataAsync 方法
• CoreWebView2BrowsingDataKinds 枚举

WinRT/C#

• CoreWebView2Environment 类：
  • CoreWebView2Environment.CreateCoreWebView2CompositionControllerAsync 方法
  • CoreWebView2Environment.CreateCoreWebView2ControllerAsync 方法
  • CoreWebView2Environment.CreateCoreWebView2ControllerAsync) 方法 (选项
  • CoreWebView2Environment.CreateCoreWebView2ControllerOptions 方法
  • CoreWebView2Environment.UserDataFolder 属性
• CoreWebView2EnvironmentOptions 类：
  • CoreWebView2EnvironmentOptions.ExclusiveUserDataFolderAccess 属性

清除浏览数据：

• CoreWebView2Profile 类：
  • CoreWebView2Profile.ClearBrowsingDataAsync 方法
• CoreWebView2BrowsingDataKinds 枚举

Win32/C++

• ICoreWebView2Environment7 接口：
  • ICoreWebView2Environment7：：get_UserDataFolder 方法
• ICoreWebView2Environment10 接口：
  • ICoreWebView2Environment10：：CreateCoreWebView2CompositionControllerWithOptions 方法
  • ICoreWebView2Environment10：：CreateCoreWebView2ControllerOptions 方法
  • ICoreWebView2Environment10：：CreateCoreWebView2ControllerWithOptions 方法
• ICoreWebView2EnvironmentOptions2 接口：
  • ICoreWebView2EnvironmentOptions2：：get_ExclusiveUserDataFolderAccess 方法
  • ICoreWebView2EnvironmentOptions2：:p ut_ExclusiveUserDataFolderAccess 方法

清除浏览数据：

• ICoreWebView2Profile2 接口：
  • ICoreWebView2Profile2：：ClearBrowsingData 方法
  • ICoreWebView2Profile2：：ClearBrowsingDataAll 方法
  • ICoreWebView2Profile2：：ClearBrowsingDataInTimeRange 方法
• COREWEBVIEW2_BROWSING_DATA_KINDS枚举

多个配置文件

管理单个用户数据文件夹下的多个配置文件。

另请参阅：

• 支持单个用户数据文件夹下的多个配置文件

.NET/C#

Create定义配置文件的 options 对象：

• CoreWebView2Environment 类：
  • CoreWebView2Environment.CreateCoreWebView2ControllerOptions 方法
• CoreWebView2ControllerOptions 类

Create使用配置文件的 WebView2 控件：

• CoreWebView2Environment 类：
  • CoreWebView2Environment.CreateCoreWebView2CompositionControllerAsync 方法
  • CoreWebView2Environment.CreateCoreWebView2ControllerAsync 方法

访问和操作配置文件：

• CoreWebView2 类：
  • CoreWebView2.Profile 属性
• CoreWebView2Profile 类

WinRT/C#

Create定义配置文件的 options 对象：

• CoreWebView2Environment 类：
  • CoreWebView2Environment.CreateCoreWebView2ControllerOptions 方法
• CoreWebView2ControllerOptions 类

Create使用配置文件的 WebView2 控件：

• CoreWebView2Environment 类：
  • CoreWebView2Environment.CreateCoreWebView2CompositionControllerAsync (parentWindow) 方法
  • CoreWebView2Environment.CreateCoreWebView2CompositionControllerAsync (parentWindow，选项) 方法
  • CoreWebView2Environment.CreateCoreWebView2ControllerAsync (parentWindow，选项) 方法
  • CoreWebView2Environment.CreateCoreWebView2ControllerAsync (parentWindow) 方法

访问和操作配置文件：

• CoreWebView2 类：
  • CoreWebView2.Profile 属性
• CoreWebView2Profile 类

Win32/C++

Create定义配置文件的 options 对象：

• ICoreWebView2Environment10 接口：
  • ICoreWebView2Environment10：：CreateCoreWebView2ControllerOptions 方法
• ICoreWebView2ControllerOptions 接口

Create使用配置文件的 WebView2 控件：

• ICoreWebView2Environment10 接口：
  • ICoreWebView2Environment10：：CreateCoreWebView2ControllerWithOptions 方法
  • ICoreWebView2Environment10：：CreateCoreWebView2CompositionControllerWithOptions 方法

访问和操作配置文件：

• ICoreWebView2_13 接口：
  • ICoreWebView2_13：：get_Profile 方法
• ICoreWebView2Profile 接口
• ICoreWebView2Profile2 接口 - 清除浏览数据。
• ICoreWebView2Profile6 接口 - 自动填充和密码自动保存。

删除配置文件

应用可以删除 WebView2 Web 浏览器控件的用户配置文件。

另请参阅：

• 管理用户数据文件夹

.NET/C#

• CoreWebView2Profile 类：
  • CoreWebView2Profile.Delete 方法
  • CoreWebView2Profile.Deleted 事件

WinRT/C#

• CoreWebView2Profile 类：
  • CoreWebView2Profile.Delete 方法
  • CoreWebView2Profile.Deleted 事件

Win32/C++

• ICoreWebView2Profile8

  • ICoreWebView2Profile8：：add_Deleted
  • ICoreWebView2Profile8：:D elete
  • ICoreWebView2Profile8：：remove_Deleted

• ICoreWebView2ProfileDeletedEventHandler

运行时选择

运行时选择支持预发布测试和自承载。 创建 WebView2 环境时：

• 若要指定浏览器预览通道的搜索顺序，请使用 CoreWebView2EnvironmentOptions.ChannelSearchKind 属性。
• 若要指定搜索哪些浏览器预览通道，请使用 CoreWebView2EnvironmentOptions.ReleaseChannels 属性。

另请参阅：

• 测试即将推出的 API 和功能

.NET/C#

• CoreWebView2EnvironmentOptions 类：

  • CoreWebView2EnvironmentOptions.ChannelSearchKind 属性
  • CoreWebView2EnvironmentOptions.ReleaseChannels 属性

• CoreWebView2ChannelSearchKind Enum

  • MostStable
  • LeastStable

• CoreWebView2ReleaseChannels 枚举

  • None
  • Stable
  • Beta
  • Dev
  • Canary

WinRT/C#

• CoreWebView2EnvironmentOptions 类：

  • CoreWebView2EnvironmentOptions.ChannelSearchKind 属性
  • CoreWebView2EnvironmentOptions.ReleaseChannels 属性

• CoreWebView2ChannelSearchKind Enum

  • MostStable
  • LeastStable

• CoreWebView2ReleaseChannels 枚举

  • None
  • Stable
  • Beta
  • Dev
  • Canary

Win32/C++

• ICoreWebView2EnvironmentOptions7

  • ICoreWebView2EnvironmentOptions7：：get_ChannelSearchKind
  • ICoreWebView2EnvironmentOptions7：:p ut_ChannelSearchKind
  • ICoreWebView2EnvironmentOptions7：：get_ReleaseChannels
  • ICoreWebView2EnvironmentOptions7：:p ut_ReleaseChannels

• COREWEBVIEW2_CHANNEL_SEARCH_KIND 枚举

  • COREWEBVIEW2_CHANNEL_SEARCH_KIND_MOST_STABLE
  • COREWEBVIEW2_CHANNEL_SEARCH_KIND_LEAST_STABLE

• COREWEBVIEW2_RELEASE_CHANNELS枚举

  • COREWEBVIEW2_RELEASE_CHANNELS_NONE
  • COREWEBVIEW2_RELEASE_CHANNELS_STABLE
  • COREWEBVIEW2_RELEASE_CHANNELS_BETA
  • COREWEBVIEW2_RELEASE_CHANNELS_DEV
  • COREWEBVIEW2_RELEASE_CHANNELS_CANARY

性能和调试

分析和调试性能，处理与性能相关的事件，并管理内存使用情况，以提高应用的响应能力。

以下小节：

• 内存使用目标

.NET/C#

• CoreWebView2 类：
  • CoreWebView2.TrySuspendAsync 方法
  • CoreWebView2.IsSuspended 属性
  • CoreWebView2.Resume 方法
  • CoreWebView2.OpenTaskManagerWindow 方法

WinRT/C#

• CoreWebView2 类：
  • CoreWebView2.TrySuspendAsync 方法
  • CoreWebView2.IsSuspended 属性
  • CoreWebView2.Resume 方法
  • CoreWebView2.OpenTaskManagerWindow 方法

Win32/C++

• ICoreWebView2_3 接口：

  • ICoreWebView2_3：：TrySuspend 方法
  • ICoreWebView2_3：：get_IsSuspended 方法
  • ICoreWebView2_3：：Resume 方法

• ICoreWebView2_6 接口：

  • ICoreWebView2_6：：OpenTaskManagerWindow 方法

内存使用目标

指定内存消耗级别，例如 low 或 normal。

.NET/C#

• CoreWebView2 类：
  • CoreWebView2.MemoryUsageTargetLevel 属性
• CoreWebView2MemoryUsageTargetLevel Enum

WinRT/C#

• CoreWebView2 类：
  • CoreWebView2.MemoryUsageTargetLevel 属性
• CoreWebView2MemoryUsageTargetLevel Enum

Win32/C++

• ICoreWebView2_19 接口
  • ICoreWebView2_19：：get_MemoryUsageTargetLevel
  • ICoreWebView2_19：:p ut_MemoryUsageTargetLevel
• COREWEBVIEW2_MEMORY_USAGE_TARGET_LEVEL枚举

Chrome DevTools 协议 (CDP)

Chrome DevTools 协议 (CDP) 提供用于检测、检查、调试和分析基于Chromium的浏览器的 API。 Chrome DevTools 协议是 Microsoft Edge DevTools 的基础。 将 Chrome DevTools 协议用于 WebView2 平台中未实现的功能。

另请参阅：

• 在 WebView2 应用中使用 Chrome DevTools 协议 (CDP)
• Chrome DevTools 协议

.NET/C#

打开：

• CoreWebView2Settings 类：
  • CoreWebView2Settings.AreDevToolsEnabled 属性
• CoreWebView2 类：
  • CoreWebView2.OpenDevToolsWindow 方法

叫：

• CoreWebView2 类：
  • CoreWebView2.CallDevToolsProtocolMethodAsync 方法
  • CoreWebView2.CallDevToolsProtocolMethodForSessionAsync 方法

接收机：

• CoreWebView2 类：
  • CoreWebView2.GetDevToolsProtocolEventReceiver 方法
• CoreWebView2DevToolsProtocolEventReceivedEventArgs 类
• CoreWebView2DevToolsProtocolEventReceiver 类

WinRT/C#

打开：

• CoreWebView2Settings 类：
  • CoreWebView2Settings.AreDevToolsEnabled 属性
• CoreWebView2 类：
  • CoreWebView2.OpenDevToolsWindow 方法

叫：

• CoreWebView2 类：
  • CoreWebView2.CallDevToolsProtocolMethodAsync 方法
  • CoreWebView2.CallDevToolsProtocolMethodForSessionAsync 方法

接收机：

• CoreWebView2 类：
  • CoreWebView2.GetDevToolsProtocolEventReceiver 方法
• CoreWebView2DevToolsProtocolEventReceivedEventArgs 类
• CoreWebView2DevToolsProtocolEventReceiver 类

Win32/C++

打开：

• ICoreWebView2Settings 接口：
  • ICoreWebView2Settings：：get_AreDevToolsEnabled 方法
  • ICoreWebView2Settings：:p ut_AreDevToolsEnabled 方法
• ICoreWebView2 接口：
  • ICoreWebView2：：OpenDevToolsWindow 方法

叫：

• ICoreWebView2 接口：
  • ICoreWebView2：：CallDevToolsProtocolMethod 方法
• ICoreWebView2_11 接口：
  • ICoreWebView2_11：：CallDevToolsProtocolMethodForSession 方法

接收机：

• ICoreWebView2 接口：
  • ICoreWebView2：：GetDevToolsProtocolEventReceiver 方法
• ICoreWebView2DevToolsProtocolEventReceiver 接口
• ICoreWebView2DevToolsProtocolEventReceivedEventArgs 接口

另请参阅

• Microsoft Edge WebView2 简介
• WebView2 API 参考 - 适用于其他平台和语言的 API 参考链接，例如 WinRT/C++ (COM) 。