WebView2 功能和 API 概觀

在您的應用程式中內嵌 WebView2 控制件，可讓您的應用程式存取透過 WebView2 類別或介面提供的各種方法和屬性。 WebView2 有數百個 API，提供一組廣泛的功能，範圍從增強應用程式的原生平臺功能，到讓您的應用程式能夠修改瀏覽器體驗。 本文提供 WebView2 API 的高階群組，以協助您瞭解您可以使用 WebView2 執行的不同動作。

最上層功能區域概觀

載入 WebView2 控制件時，您的應用程式可以存取下列功能和 API：

功能範圍	用途
主要類別：環境、控制器和核心	CoreWebView2Environment、 CoreWebView2Controller和 CoreWebView2 類別 (或對等介面) 一起運作，讓您的應用程式可以裝載 WebView2 瀏覽器控制項並存取其瀏覽器功能。 這些大型類別會公開您的主應用程式可以存取的各種 API，為您的使用者提供下列瀏覽器相關功能類別。
Web/原生 Interop	將 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 的基礎。 針對 WebView2 平臺中未實作的功能，請使用 Chrome DevTools 通訊協定。

此頁面只會列出發行 SDK 中的 API;它不會列出發行 SDK 中尚未提供的實驗性 API 或穩定 API。 如需包含實驗性 API 的完整 API 清單，請參閱 WebView2 SDK 的版本資訊。

主要類別：環境、控制器和核心

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/原生 Interop

Microsoft Edge WebView2 控制件可讓您將 Web 內容內嵌至原生應用程式。 您可以使用簡單的訊息、JavaScript 程式代碼和原生物件，在原生程式代碼和 Web 程式代碼之間進行通訊。 以下是在 Web 和原生程式代碼之間進行通訊的主要 API。

下列小節：

• 主機/Web 對象共用
• 腳本執行
• Web 傳訊
• 腳本對話框
• 共用緩衝區

Web/原生 Interop 的常見使用案例：

• 流覽至不同的網站之後，更新原生主機視窗標題。
• 從 Web 應用程式傳送原生相機物件並使用其方法。
• 在應用程式的 Web 端執行專用的 JavaScript 檔案。

另請參閱:

• 原生端和網頁端程序代碼的互操作性
• 從原生端程式代碼呼叫 Web 端程式代碼
• 從 Web 端程式代碼呼叫原生端程式代碼
• 從 Web 端程式代碼呼叫原生端 WinRT 程式代碼
• 適用於 JavaScript API 的 WebView2window.chrome.webview 中的 JavaScript API

主機/Web 對象共用

WebView2 可讓原生程式代碼中定義的對象傳遞至應用程式的 Web 端程式代碼。 主機物件 是您選擇傳遞至應用程式 Web 端程式代碼之原生程式代碼中定義的任何物件。

主機物件可以投影到 JavaScript，讓您可以從應用程式的 Web 端程式代碼呼叫原生物件方法 (或其他 API) 。 例如，您的應用程式可以呼叫這類 API，因為使用者在應用程式的 Web 端互動。 如此一來，您就不需要在 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 支援 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 sharedBufferToScript 方法
• 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 工具列
• 佈景主題
• Language
• 新增視窗
• 關閉視窗
• 檔標題
• 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 列舉
  • None
  • Basic
  • Balanced
  • Strict

WinRT/C#

• CoreWebView2EnvironmentOptions 類：
  • CoreWebView2EnvironmentOptions.EnableTrackingPrevention 属性
• CoreWebView2Profile 類：
  • CoreWebView2Profile.PreferredTrackingPreventionLevel 属性
• CoreWebView2TrackingPreventionLevel 列舉
  • 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列舉

框架處理程序資訊

包括 GetProcessExtendedInfos在內的框架處理程式資訊 API 提供所有在相關聯轉譯器進程中執行之框架的快照集集合。 此 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

iframe 可讓您將其他網頁內嵌到您自己的網頁。 在 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 架構，且使用 Composition - 如果您的應用程式 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 會調整 WebView2 的大小，並放置相對於父系 HWND的 WebView2。 WebView2 的可見性可以使用 IsVisible切換。

.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 方法

協助工具

根據預設，WebView2 會在輔助功能樹狀結構中顯示為 Win32/C++ 應用程式的父 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， options) Method
  • CoreWebView2Environment.CreateCoreWebView2ControllerAsync (parentWindow， options) Method
  • 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 網頁瀏覽器控制件的使用者配置檔。

另請參閱:

• 管理用戶資料資料夾

.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 列舉

  • MostStable
  • LeastStable

• CoreWebView2ReleaseChannels 列舉

  • None
  • Stable
  • Beta
  • Dev
  • Canary

WinRT/C#

• CoreWebView2EnvironmentOptions 類：

  • CoreWebView2EnvironmentOptions.ChannelSearchKind 屬性
  • CoreWebView2EnvironmentOptions.ReleaseChannels 屬性

• CoreWebView2ChannelSearchKind 列舉

  • 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 列舉

WinRT/C#

• CoreWebView2 類：
  • CoreWebView2.MemoryUsageTargetLevel 屬性
• CoreWebView2MemoryUsageTargetLevel 列舉

Win32/C++

• ICoreWebView2_19介面
  • ICoreWebView2_19：：get_MemoryUsageTargetLevel
  • ICoreWebView2_19：:p ut_MemoryUsageTargetLevel
• COREWEBVIEW2_MEMORY_USAGE_TARGET_LEVEL列舉

Chrome DevTools 通訊協定 (CDP)

Chrome DevTools 通訊協定 (CDP) 提供 API 來檢測、檢查、偵錯和設定檔 Chromium 型瀏覽器。 Chrome DevTools 通訊協定是 Microsoft Edge DevTools 的基礎。 針對 WebView2 平臺中未實作的功能，請使用 Chrome DevTools 通訊協定。

另請參閱:

• 在 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) 。