WebView2 API 概述

將 WebView2 控制項嵌入應用程式，即可存取 WebView2 類別或介面所提供的各種方法與屬性。

WebView2 擁有數百個 API，提供廣泛的功能，從提升應用程式原生平台的功能，到讓應用程式能修改瀏覽器體驗。 本文將 WebView2 API 的高層次分類，幫助你了解使用 WebView2 可以做的各種事情。

詳細內容：

• 頂層特徵區域概述
• 主要類別：環境、控制器與核心
• 網頁/原生互通
  • 主機/網頁物件共享
  • 腳本執行
  • 網路訊息
  • 腳本對話
  • 共享緩衝區
• 瀏覽器功能
  • 列印
  • Cookie
  • 影像擷取
    • 控制螢幕截圖介面是否顯示
  • Find
  • 下載
  • 另存為
    • 儲存檔案時設定安全警告
  • 網頁通知處理
  • 權限
  • 快顯功能表
  • 狀態列
  • 流暢疊加捲軸條
  • 使用者代理
  • 自動填充
  • 音訊
  • 地區滑鼠點擊的測試
  • 滑動手勢導航
  • 啟用或停用對加速鍵 (快捷鍵的瀏覽器反應)
  • 全螢幕
  • PDF 工具列
  • 佈景主題
  • Language
  • 新視窗
  • 關閉視窗
  • 文件標題
  • Favicon
  • 安全性及隱私權
    • 追蹤預防
    • 智慧螢幕
    • 自訂崩潰報告
  • 瀏覽器擴充功能
• 流程管理
  • 框架工藝資訊
• 瀏覽頁面並管理已載入的內容
  • 管理載入於 WebView2 的內容
  • 航行歷史
  • 導航類型
  • 封鎖不受歡迎的導航
  • 導航活動
  • 在 WebView2 管理網路請求
  • 自訂方案註冊
  • 用戶端憑證
  • 伺服器憑證
  • 啟動外部 URI 方案
• iframes
• 驗證
• 在非框架應用程式中渲染 WebView2
  • 何時使用這些 API
  • 尺寸、位置與可見度
  • 縮放
  • 光柵化尺度
  • 焦點與制表
  • 父視窗
  • 鍵盤加速器
  • 預設背景色
• 使用合成來渲染 WebView2
  • 連接視覺樹
  • 轉發輸入
  • 允許輸入事件訊息通過瀏覽器視窗
  • 拖放
  • 協助工具
• 環境選項
  • 使用者資料
    • 多重設定檔
    • 刪除設定檔
  • 執行時選擇
• 效能與除錯
  • 記憶體使用目標
• Chrome DevTools 協定 (CDP)
• 另請參閱

頂層特徵區域概述

當 WebView2 控制項託管時，您的應用程式可使用以下功能與 API：

功能範圍	用途
主要類別：環境、控制器與核心	CoreWebView2Environment、、 CoreWebView2Controller以及CoreWebView2類別 (或等效介面，) 協同運作，使你的應用程式能承載 WebView2 瀏覽器控制並存取其瀏覽器功能。 這些大型類別會暴露出各種 API，讓你的主機應用程式能存取，為使用者提供以下幾類瀏覽器相關功能。
網頁/原生互通	將網頁內容嵌入原生應用程式中。 利用簡單訊息、JavaScript 程式碼和原生物件，在原生程式碼與網頁程式碼間進行通訊。
瀏覽器功能	WebView2 控制項讓你的應用程式能存取許多瀏覽器功能。 你可以修改這些瀏覽器功能，並開啟或關閉它們。
流程管理	取得有關執行 WebView2 程序、退出程序及失敗程序的資訊，讓您的應用程式能相應採取行動。
瀏覽頁面並管理已載入的內容	管理網頁導覽及網頁載入的內容。
iframes	將其他網頁嵌入你自己的網頁中。 偵測嵌入網頁何時建立、偵測嵌入網頁是否在導航，並可選擇性地繞過 x-frame 選項。
驗證	你的應用程式可以用 WebView2 控制來處理基本的認證。 基本認證 是一種特定的認證方法，屬於 HTTP 協議的一部分。
在非框架應用程式中渲染 WebView2	如果你的主機應用程式沒有使用 UI 框架，請使用這些 API 來設定 WebView2 的渲染系統。 這個渲染設定控制 WebView2 如何將輸出渲染到你的主機應用程式，以及 WebView2 如何處理輸入、焦點和無障礙。
使用合成來渲染 WebView2	對於基於合成的 WebView2 渲染，請使用 CoreWebView2Environment 來建立一個 CoreWebView2CompositionController。 CoreWebView2CompositionController 提供與 CoreWebView2Controller相同的 API，但也包含基於組合的渲染 API。
環境選項	使用者資料：管理使用者資料資料夾 (UDF) ，該資料夾位於使用者機器上。 UDF 包含與主機應用程式及 WebView2 相關的資料。 WebView2 應用程式使用使用者資料資料夾來儲存瀏覽器資料，例如 Cookie、權限和快取資源。 在單一 UDF 下管理多個設定檔。 執行時選擇 支援預發布測試與自我架設。 你可以指定瀏覽器預覽頻道的搜尋順序，並指定搜尋哪些瀏覽器預覽頻道。
效能與除錯	分析與除錯效能、處理效能相關事件，並管理記憶體使用，以提升應用程式的反應速度。
Chrome DevTools 協定 (CDP)	對基於 Chromium 的瀏覽器進行檢查、檢查、除錯及設定檔。 Chrome DevTools 協定 (CDP) 是 Microsoft Edge DevTools 的基礎。 對於 WebView2 平台未實作的功能，請使用 Chrome DevTools 協定。

本頁僅列出 Release SDK 中的 API;它沒有列出實驗性 API，也沒有在 Release SDK 中尚未提供過的穩定 API。 如需完整的 API 清單，包括實驗性 API，請參閱 WebView2 SDK 的發行說明。

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

CoreWebView2Environment、、 CoreWebView2Controller以及CoreWebView2類別 (或等效介面，) 協同運作，使你的應用程式能承載 WebView2 瀏覽器控制並存取其瀏覽器功能。 這三個大型類別會暴露出各種 API，讓你的主機應用程式能夠存取，為使用者提供多種與瀏覽器相關的功能。

• 此 CoreWebView2Environment 類別代表一組共用相同 WebView2 瀏覽器程序、使用者資料資料夾及渲染器程序的 WebView2 控制項。 從這個CoreWebView2Environment類別中，你會建立 和 CoreWebView2 的實例對CoreWebView2Controller。

• 這個 CoreWebView2Controller 類別負責與主機相關的功能，例如視窗焦點、可見性、大小和輸入，而你的應用程式則承載 WebView2 控制項。

• 本 CoreWebView2 類別針對 WebView2 控制項中特定的網頁部分，包括網路、導航、腳本，以及解析與渲染 HTML。

另請參閱:

• WebView2 的主要類別：環境、控制器與核心

.NET/C#

• CoreWebView2 類別
• CoreWebView2Controller 類別
• CoreWebView2Environment 類別

WinRT/C#

• CoreWebView2 類別
• CoreWebView2Controller 類別
• CoreWebView2Environment 類別

Win32/C++

• ICoreWebView2
• ICoreWebView2Controller
• ICoreWebView2Environment

網頁/原生互通

Microsoft Edge WebView2 控制功能讓你能將網頁內容嵌入原生應用程式中。 你可以用簡單的訊息、JavaScript 程式碼和原生物件，在原生程式碼和網頁程式碼之間溝通。 以下是用於網頁與原生程式碼間通訊的主要 API。

網頁/原生互通的常見使用案例：

• 在瀏覽到其他網站後，更新原生主機視窗標題。
• 傳送一個原生相機物件，並從網頁應用程式中使用其方法。
• 在應用程式的網頁端執行一個專用的 JavaScript 檔案。

另請參閱:

• 原生與網頁程式碼的互通性
• 從原生端程式碼呼叫網頁端程式碼
• 從網頁端程式碼呼叫原生端程式碼
• 從網頁端程式碼呼叫原生端的 WinRT 程式碼
• WebView2 中的 JavaScript API for window.chrome.webview JavaScript API

主機/網頁物件共享

WebView2 允許以原生程式碼定義的物件傳遞到應用程式的網頁端程式碼。 主機物件 是指任何以原生程式碼定義，並由你選擇傳入應用程式網頁端程式碼的物件。

主機物件可以投影成 JavaScript，讓你能從應用程式的網頁端程式碼) 呼叫原生物件方法 (或其他 API。 例如，你的應用程式可以因為使用者在網頁端的互動而呼叫這些 API。 這樣一來，你就不需要在網頁端程式碼中重新實作原生物件的 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 控制項內的網頁內容中新增 JavaScript 程式碼。

.NET/C#

• CoreWebView2 班：
  • CoreWebView2.AddScriptToExecuteOnDocumentCreatedAsync 方法
  • CoreWebView2.ExecuteScriptAsync 方法
  • CoreWebView2.ExecuteScriptWithResultAsync 方法
  • CoreWebView2.RemoveScriptToExecuteOnDocumentCreated 方法
• CoreWebView2ExecuteScriptResult 類別
  • CoreWebView2ExecuteScriptResult.Exception 屬性
  • CoreWebView2ExecuteScriptResult.ResultAsJson Property
  • CoreWebView2ExecuteScriptResult.Succeeded 屬性
  • CoreWebView2ExecuteScriptResult.TryGetResultAsString 方法
• CoreWebView2Frame 班：
  • CoreWebView2Frame.ExecuteScriptAsync 方法
• CoreWebView2ScriptException 類別
  • CoreWebView2ScriptException.ColumnNumber 屬性
  • CoreWebView2ScriptException.LineNumber 屬性
  • CoreWebView2ScriptException.Message 屬性
  • CoreWebView2ScriptException.Name 財產
  • CoreWebView2ScriptException.ToJson Property
• CoreWebView2Settings 班：
  • CoreWebView2Settings.IsScriptEnabled 屬性

WinRT/C#

• CoreWebView2 班：
  • CoreWebView2.AddScriptToExecuteOnDocumentCreatedAsync 方法
  • CoreWebView2.ExecuteScriptAsync 方法
  • CoreWebView2.ExecuteScriptWithResultAsync 屬性
  • CoreWebView2.RemoveScriptToExecuteOnDocumentCreated 方法
• CoreWebView2ExecuteScriptResult 類別
  • CoreWebView2ExecuteScriptResult.Exception 屬性
  • CoreWebView2ExecuteScriptResult.ResultAsJson Property
  • CoreWebView2ExecuteScriptResult.Succeeded 屬性
  • CoreWebView2ExecuteScriptResult.TryGetResultAsString Property
• CoreWebView2Frame 班：
  • CoreWebView2Frame.ExecuteScriptAsync 方法
• CoreWebView2ScriptException 類別
  • CoreWebView2ScriptException.ColumnNumber 屬性
  • CoreWebView2ScriptException.LineNumber 屬性
  • CoreWebView2ScriptException.Message 屬性
  • CoreWebView2ScriptException.Name 財產
  • CoreWebView2ScriptException.ToJson Property
• 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 方法

網路訊息

你的應用程式可以向 WebView2 控制範圍內的網頁內容發送訊息，並接收來自該網頁內容的訊息。 訊息以字串或 JSON 物件形式傳送。

你可以選擇性地透過 (.NET、PostWebMessageAsJsonWinRT) (或 PostWebMessageAsJsonWithAdditionalObjects Win32) 發送並接收 DOM 物件additionalObjects。 WebView2 CoreWebView2FileSystemHandle 類別代表 DOM FileSystemHandle， CoreWebView2FileFile代表 。 另 chrome.webview.postMessageWithAdditionalObjects 見 JavaScript 參考文獻。

.NET/C#

• CoreWebView2 班：

  • CoreWebView2.PostWebMessageAsJson 方法
  • CoreWebView2.PostWebMessageAsString 方法
  • CoreWebView2.WebMessageReceived 事件

• CoreWebView2File 類別

  • CoreWebView2File.Path 屬性

• CoreWebView2Frame 班：

  • CoreWebView2Frame.PostWebMessageAsJson 方法
  • CoreWebView2Frame.PostWebMessageAsString 方法
  • CoreWebView2Frame.WebMessageReceived 事件

• CoreWebView2Settings 班：

  • CoreWebView2Settings.IsWebMessageEnabled 屬性

• CoreWebView2WebMessageReceivedEventArgs 類別

• CoreWebView2Environment 班：

  • CoreWebView2Environment.CreateWebFileSystemDirectoryHandle 方法
  • CoreWebView2Environment.CreateWebFileSystemFileHandle 方法

• CoreWebView2FileSystemHandle 班：

  • CoreWebView2FileSystemHandle.Kind 屬性
  • CoreWebView2FileSystemHandle.Path 屬性
  • CoreWebView2FileSystemHandle.Permission Property

• CoreWebView2FileSystemHandleKind Enum

  • File
  • Directory

• CoreWebView2FileSystemHandlePermission Enum

  • ReadOnly
  • ReadWrite

WinRT/C#

• CoreWebView2 班：

  • CoreWebView2.PostWebMessageAsJson 方法
  • CoreWebView2.PostWebMessageAsString 方法
  • CoreWebView2.WebMessageReceived 事件

• CoreWebView2File 類別

  • CoreWebView2File.Path 屬性

• CoreWebView2Frame 班：

  • CoreWebView2Frame.PostWebMessageAsJson 方法
  • CoreWebView2Frame.PostWebMessageAsString 方法
  • CoreWebView2Frame.WebMessageReceived 事件

• CoreWebView2Settings 班：

  • CoreWebView2Settings.IsWebMessageEnabled 屬性

• CoreWebView2WebMessageReceivedEventArgs 類別

• CoreWebView2Environment 班：

  • CoreWebView2Environment.CreateWebFileSystemDirectoryHandle Property
  • CoreWebView2Environment.CreateWebFileSystemFileHandle 屬性

• CoreWebView2FileSystemHandle 班：

  • CoreWebView2FileSystemHandle.Kind 屬性
  • CoreWebView2FileSystemHandle.Path 屬性
  • CoreWebView2FileSystemHandle.Permission Property

• CoreWebView2FileSystemHandleKind Enum

  • File
  • Directory

• CoreWebView2FileSystemHandlePermission Enum

  • ReadOnly
  • ReadWrite

Win32/C++

• ICoreWebView2 界面：

  • ICoreWebView2：:P ostWebMessageAsJson method
  • ICoreWebView2：:P ostWebMessageAsString 方法
  • ICoreWebView2：：add_WebMessageReceived
  • ICoreWebView2：：remove_WebMessageReceived

• ICoreWebView2_23

  • ICoreWebView2_23：:P ostWebMessageAsJsonWithAdditionalObjects

• ICoreWebView2File 介面

  • ICoreWebView2File：：get_Path

• ICoreWebView2Frame2 界面：

  • ICoreWebView2Frame2：:P ostWebMessageAsJson method
  • ICoreWebView2Frame2：:P ostWebMessageAsString 方法
  • ICoreWebView2Frame2：：add_WebMessageReceived
  • ICoreWebView2Frame2：：remove_WebMessageReceived

• ICoreWebView2ObjectCollectionView 介面

• ICoreWebView2Settings 界面：

  • ICoreWebView2Settings：：get_IsWebMessageEnabled
  • ICoreWebView2Settings：:p ut_IsWebMessageEnabled

• ICoreWebView2WebMessage ReceivedEventArgs 介面

• ICoreWebView2WebMessageReceivedEventArgs2 介面

• ICoreWebView2Environment14

  • ICoreWebView2Environment14：：CreateObjectCollection
  • ICoreWebView2Environment14：：CreateWebFileSystemDirectoryHandle
  • ICoreWebView2Environment14：：CreateWebFileSystemFileHandle

• ICoreWebView2FileSystemHandle

  • ICoreWebView2FileSystemHandle：：get_Kind
  • ICoreWebView2FileSystemHandle：：get_Path
  • ICoreWebView2FileSystemHandle：：get_Permission

• ICoreWebView2ObjectCollection

  • ICoreWebView2ObjectCollection：：InsertValueAtIndex
  • ICoreWebView2ObjectCollection：：RemoveValueAtIndex

• 列舉COREWEBVIEW2_FILE_SYSTEM_HANDLE_KIND

  • COREWEBVIEW2_FILE_SYSTEM_HANDLE_KIND_FILE
  • COREWEBVIEW2_FILE_SYSTEM_HANDLE_KIND_DIRECTORY

• 列舉COREWEBVIEW2_FILE_SYSTEM_HANDLE_PERMISSION

  • COREWEBVIEW2_FILE_SYSTEM_HANDLE_PERMISSION_READ_ONLY
  • COREWEBVIEW2_FILE_SYSTEM_HANDLE_PERMISSION_READ_WRITE

腳本對話

當 WebView2 運行時，你的應用程式可以管理不同的 JavaScript 對話框，以抑制它們或以自訂對話框取代。

.NET/C#

• CoreWebView2 班：
  • CoreWebView2.ScriptDialogOpening Event
• CoreWebView2ScriptDialogOpeningEventArgs 類別

WinRT/C#

• CoreWebView2 班：
  • CoreWebView2.ScriptDialogOpening Event
• CoreWebView2ScriptDialogOpeningEventArgs 類別

Win32/C++

• ICoreWebView2 界面：
  • ICoreWebView2：：add_ScriptDialogOpening方法
  • ICoreWebView2：：remove_ScriptDialogOpening方法
• ICoreWebView2ScriptDialogOpeningEventArgs 介面

共享緩衝區

SharedBuffer API 支援基於作業系統共享記憶體，在 WebView2 主機應用程式程序與 WebView2 渲染程序之間共享緩衝區。

另請參閱:

• SharedBufferReceivedEvent 類別

.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 Enum
  • ReadOnly
  • ReadWrite

WinRT/C#

• CoreWebView2 班：
  • CoreWebView2.PostSharedBufferToScript 方法
• CoreWebView2Environment 班：
  • ICoreWebView2Environment.CreateSharedBuffer 方法
• CoreWebView2Frame 班：
  • CoreWebView2Frame.PostSharedBufferToScript 方法
• CoreWebView2SharedBuffer 類別
  • CoreWebView2SharedBuffer.Buffer 屬性
  • CoreWebView2SharedBuffer.Size 屬性
  • CoreWebView2SharedBuffer.Close 方法
  • CoreWebView2SharedBuffer.OpenStream 方法
• CoreWebView2SharedBufferAccess Enum
  • 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 控制項讓你的應用程式能存取許多瀏覽器功能。 你可以修改這些瀏覽器功能，並開啟或關閉它們。

列印

你可以透過設定自訂列印設定，將網頁列印到印表機、PDF 檔案或 PDF 串流。

另請參閱:

• 從 WebView2 應用程式列印

.NET/C#

• CoreWebView2 班：
  • CoreWebView2.ShowPrintUI 方法
  • CoreWebView2.PrintAsync 方法
  • CoreWebView2.PrintToPdfAsync 方法
  • CoreWebView2.PrintToPdfStreamAsync 方法
• CoreWebView2Environment 班：
  • CoreWebView2Environment.CreatePrintSettings 方法
• CoreWebView2PrintSettings 類別
• CoreWebView2PrintDialogKind Enum
• CoreWebView2PrintStatus Enum

WinRT/C#

• CoreWebView2 班：
  • CoreWebView2.ShowPrintUI 方法
  • CoreWebView2.PrintAsync 方法
  • CoreWebView2.PrintToPdfAsync 方法
  • CoreWebView2.PrintToPdfStreamAsync 方法
• CoreWebView2Environment 班：
  • CoreWebView2Environment.CreatePrintSettings 方法
• CoreWebView2PrintSettings 類別
• CoreWebView2PrintDialogKind Enum
• CoreWebView2PrintStatus Enum

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

控制螢幕截圖介面是否顯示

ScreenCaptureStarting當對應CoreWebView2Frame該 (或其後繼 iframe) 在顯示 UI 前請求使用螢幕擷取 API 的權限時，該事件就會被觸發。 應用程式可以阻擋 UI 顯示，或允許顯示該 UI。

.NET/C#

• CoreWebView2 班：

  • CoreWebView2.ScreenCaptureStarting Event

• CoreWebView2Frame 班：

  • CoreWebView2Frame.ScreenCaptureStarting Event

• CoreWebView2NonClientRegionKind 枚舉：

  • CoreWebView2NonClientRegionKind.Minimize
  • CoreWebView2NonClientRegionKind.Maximize
  • CoreWebView2NonClientRegionKind.Close

• CoreWebView2ScreenCaptureStartingEventArgs 類別

  • CoreWebView2ScreenCaptureStartingEventArgs.Cancel 屬性
  • CoreWebView2ScreenCaptureStartingEventArgs.Handled 屬性
  • CoreWebView2ScreenCaptureStartingEventArgs.OriginalSourceFrameInfo 屬性
  • CoreWebView2ScreenCaptureStartingEventArgs.GetDeferral 方法

WinRT/C#

• CoreWebView2 班：

  • CoreWebView2.ScreenCaptureStarting Event

• CoreWebView2Frame 班：

  • CoreWebView2Frame.ScreenCaptureStarting Event

• CoreWebView2NonClientRegionKind 枚舉：

  • CoreWebView2NonClientRegionKind.Minimize
  • CoreWebView2NonClientRegionKind.Maximize
  • CoreWebView2NonClientRegionKind.Close

• CoreWebView2ScreenCaptureStartingEventArgs 類別

  • CoreWebView2ScreenCaptureStartingEventArgs.Cancel 屬性
  • CoreWebView2ScreenCaptureStartingEventArgs.Handled 屬性
  • CoreWebView2ScreenCaptureStartingEventArgs.OriginalSourceFrameInfo 屬性
  • CoreWebView2ScreenCaptureStartingEventArgs.GetDeferral 方法

Win32/C++

• ICoreWebView2_27

  • ICoreWebView2_27：：add_ScreenCaptureStarting
  • ICoreWebView2_27：：remove_ScreenCaptureStarting

• ICoreWebView2Frame6

  • ICoreWebView2Frame6：：add_ScreenCaptureStarting
  • ICoreWebView2Frame6：：remove_ScreenCaptureStarting

• ICoreWebView2FrameScreenCaptureStartingEventHandler

• ICoreWebView2ScreenCaptureStartingEventArgs

  • ICoreWebView2ScreenCaptureStartingEventArgs：：get_Cancel
  • ICoreWebView2ScreenCaptureStartingEventArgs：：get_Handled
  • ICoreWebView2ScreenCaptureStartingEventArgs：：get_OriginalSourceFrameInfo
  • ICoreWebView2ScreenCaptureStartingEventArgs：：GetDeferral
  • ICoreWebView2ScreenCaptureStartingEventArgs：:p ut_Cancel
  • ICoreWebView2ScreenCaptureStartingEventArgs：:p ut_Handled

• ICoreWebView2ScreenCaptureStartingEventHandler

• COREWEBVIEW2_NON_CLIENT_REGION_KIND ENUM：

  • COREWEBVIEW2_NON_CLIENT_REGION_KIND_MINIMIZE
  • COREWEBVIEW2_NON_CLIENT_REGION_KIND_MAXIMIZE
  • COREWEBVIEW2_NON_CLIENT_REGION_KIND_CLOSE

Find

Find API 允許你以程式方式控制 Find 操作，並能為您的應用程式新增以下功能：

• 自訂搜尋選項，包括尋找詞彙、大小寫敏感度、Word 匹配、匹配高亮及預設 UI 抑制。
• 找到文字字串，並在 WebView2 控制項中切換。
• 程式化啟動 搜尋 操作，並瀏覽 搜尋 結果。
• 抑制預設 的搜尋 介面。
• 追蹤 尋找 行動的狀態。

PDF 文件的 Find API 已知存在問題。 當你在 WebView2 控制項中查看 PDF 文件時， 搜尋 功能目前只會顯示第一個索引和找到的匹配數量。 例如，如果該字串在 PDF 中出現三次，介面會顯示 1/3 ，且無法程式化呼叫 Next 或 Previous 。

我們正在積極調查這些問題，並鼓勵您透過 WebView2Feedback 倉庫回報遇到的任何問題。

.NET/C#

• CoreWebView2 班：

  • CoreWebView2.尋找屬性

• CoreWebView2Environment 班：

  • CoreWebView2Environment.CreateFindOptions 方法

• CoreWebView2Find 類別

  • CoreWebView2Find.ActiveMatchIndex 屬性
  • CoreWebView2Find.ActiveMatchIndexChanged 事件
  • CoreWebView2Find.FindNext 方法
  • CoreWebView2Find.FindPrevious 方法
  • CoreWebView2Find.MatchCount 屬性
  • CoreWebView2Find.MatchCountChanged 事件
  • CoreWebView2Find.StartAsync 方法
  • CoreWebView2Find.Stop 方法

• CoreWebView2FindOptions 類別

  • CoreWebView2FindOptions.FindTerm 屬性
  • CoreWebView2FindOptions.IsCaseSensitive 屬性
  • CoreWebView2FindOptions.ShouldHighlightAllMatches Property
  • CoreWebView2FindOptions.ShouldMatchWord 屬性
  • CoreWebView2FindOptions.SuppressDefaultFindDialog 屬性

WinRT/C#

• CoreWebView2 班：

  • CoreWebView2.尋找屬性

• CoreWebView2Environment 班：

  • CoreWebView2Environment.CreateFindOptions 屬性

• CoreWebView2Find 類別

  • CoreWebView2Find.ActiveMatchIndex 屬性
  • CoreWebView2Find.ActiveMatchIndexChanged 事件
  • 核心WebView2Find.FindNext 屬性
  • CoreWebView2Find.FindPrevious Property
  • CoreWebView2Find.MatchCount 屬性
  • CoreWebView2Find.MatchCountChanged 事件
  • CoreWebView2Find.StartAsync 屬性
  • CoreWebView2Find.Stop 方法

• CoreWebView2FindOptions 類別

  • CoreWebView2FindOptions.FindTerm 屬性
  • CoreWebView2FindOptions.IsCaseSensitive 屬性
  • CoreWebView2FindOptions.ShouldHighlightAllMatches Property
  • CoreWebView2FindOptions.ShouldMatchWord 屬性
  • CoreWebView2FindOptions.SuppressDefaultFindDialog 屬性

Win32/C++

• ICoreWebView2_28

  • ICoreWebView2_28：：get_Find

• ICoreWebView2Environment15

  • ICoreWebView2Environment15：：CreateFindOptions

• ICoreWebView2Find

  • ICoreWebView2Find：：add_ActiveMatchIndexChanged
  • ICoreWebView2Find：：add_MatchCountChanged
  • ICoreWebView2Find：：FindNext（尋找下一步）
  • ICoreWebView2Find：：FindPrevious
  • ICoreWebView2Find：：get_ActiveMatchIndex
  • ICoreWebView2Find：：get_MatchCount
  • ICoreWebView2Find：：remove_ActiveMatchIndexChanged
  • ICoreWebView2Find：：remove_MatchCountChanged
  • ICoreWebView2Find：：Start
  • ICoreWebView2Find：：停止

• ICoreWebView2FindActiveMatchIndexChangedEventHandler

• ICoreWebView2FindMatchCountChangedEventHandler

• ICoreWebView2FindOptions

  • ICoreWebView2FindOptions：：get_FindTerm
  • ICoreWebView2FindOptions：：get_IsCaseSensitive
  • ICoreWebView2FindOptions：：get_ShouldHighlightAllMatches
  • ICoreWebView2FindOptions：：get_ShouldMatchWord
  • ICoreWebView2FindOptions：：get_SuppressDefaultFindDialog
  • ICoreWebView2FindOptions：:p ut_FindTerm（尋找詞彙）
  • ICoreWebView2FindOptions：:p ut_IsCaseSensitive
  • ICoreWebView2FindOptions：:p ut_ShouldHighlightAllMatch（所有配對）
  • ICoreWebView2FindOptions：:p ut_ShouldMatchWord
  • ICoreWebView2FindOptions：:p ut_SuppressDefaultFindDialogue

• ICoreWebView2FindStartCompletedHandler

下載

你的應用程式可以在 WebView2 中管理下載體驗。 你的應用程式可以：

• 根據不同的元資料允許或阻擋下載。
• 更改下載位置。
• 設定自訂下載介面。
• 自訂預設介面。

.NET/C#

一般：

• CoreWebView2 班：
  • CoreWebView2.IsDefaultDownloadDialogOpenChanged Event
  • CoreWebView2.IsDefaultDownloadDialogOpen Property
  • CoreWebView2.OpenDefaultDownloadDialog 方法
  • CoreWebView2.CloseDefaultDownloadDialog 方法

修改預設體驗：

• CoreWebView2 班：
  • CoreWebView2.DefaultDownloadDialogCornerAlignment 屬性
  • CoreWebView2.DefaultDownloadDialogMargin 屬性
• CoreWebView2Profile 班：
  • CoreWebView2Profile.DefaultDownloadFolderPath 屬性

自訂下載體驗：

• CoreWebView2 班：
  • CoreWebView2.DownloadStarting Event
• CoreWebView2DownloadStartingEventArgs 類別
• CoreWebView2DownloadOperation 類別

WinRT/C#

一般：

• CoreWebView2 班：
  • CoreWebView2.IsDefaultDownloadDialogOpenChanged Event
  • CoreWebView2.IsDefaultDownloadDialogOpen Property
  • CoreWebView2.OpenDefaultDownloadDialog 方法
  • CoreWebView2.CloseDefaultDownloadDialog 方法

修改預設體驗：

• CoreWebView2 班：
  • CoreWebView2.DefaultDownloadDialogCornerAlignment 屬性
  • CoreWebView2.DefaultDownloadDialogMargin 屬性
• CoreWebView2Profile 班：
  • CoreWebView2Profile.DefaultDownloadFolderPath 屬性

自訂下載體驗：

• CoreWebView2 班：
  • CoreWebView2.DownloadStarting Event
• CoreWebView2DownloadStartingEventArgs 類別
• CoreWebView2DownloadOperation 類別

Win32/C++

一般：

• ICoreWebView2_9 界面：
  • ICoreWebView2_9：：get_IsDefaultDownloadDialogOpen 方法
  • ICoreWebView2_9：：OpenDefaultDownloadDialog 方法
  • ICoreWebView2_9：：add_IsDefaultDownloadDialogOpenChanged方法
  • ICoreWebView2_9：：remove_IsDefaultDownloadDialogOpenChanged 方法。
  • ICoreWebView2_9：：關閉Default下載對話框方法

修改預設體驗：

• 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 介面

另存為

另存為 API 允許你以程式方式執行 另存為 操作。 你可以用這些 API 封鎖預設的 另存 為對話框，然後靜默儲存，或自己建立另 存為 UI。 這些 API 僅適用於 另存為 對話框，不適用於使用下載 API 的 下載 對話框。

.NET/C#

• CoreWebView2 班：

  • CoreWebView2.ShowSaveAsUIAsync 方法
  • CoreWebView2.SaveAsUIShowing Event

• CoreWebView2SaveAsKind Enum

  • Complete
  • Default
  • HtmlOnly
  • SingleFile

• CoreWebView2SaveAsUIResult Enum

  • Cancelled
  • FileAlreadyExists
  • InvalidPath
  • KindNotSupported
  • Success

• CoreWebView2SaveAsUIShowingEventArgs Class

  • CoreWebView2SaveAsUIShowingEventArgs.AllowReplace Property
  • CoreWebView2SaveAsUIShowingEventArgs.Cancel Property
  • CoreWebView2SaveAsUIShowingEventArgs.ContentMimeType Property
  • CoreWebView2SaveAsUIShowingEventArgs.Kind 屬性
  • CoreWebView2SaveAsUIShowingEventArgs.SaveAsFilePath Property
  • CoreWebView2SaveAsUIShowingEventArgs.SuppressDefaultDialog 屬性
  • CoreWebView2SaveAsUIShowingEventArgs.GetDeferral Method

WinRT/C#

• CoreWebView2 班：

  • CoreWebView2.ShowSaveAsUIAsync 方法
  • CoreWebView2.SaveAsUIShowing Event

• CoreWebView2SaveAsKind Enum

  • Default
  • HtmlOnly
  • SingleFile
  • Complete

• CoreWebView2SaveAsUIResult Enum

  • Success
  • InvalidPath
  • FileAlreadyExists
  • KindNotSupported
  • Cancelled

• CoreWebView2SaveAsUIShowingEventArgs Class

  • CoreWebView2SaveAsUIShowingEventArgs.AllowReplace Property
  • CoreWebView2SaveAsUIShowingEventArgs.Cancel Property
  • CoreWebView2SaveAsUIShowingEventArgs.ContentMimeType Property
  • CoreWebView2SaveAsUIShowingEventArgs.Kind 屬性
  • CoreWebView2SaveAsUIShowingEventArgs.SaveAsFilePath Property
  • CoreWebView2SaveAsUIShowingEventArgs.SuppressDefaultDialog 屬性
  • CoreWebView2SaveAsUIShowingEventArgs.GetDeferral Method

Win32/C++

• ICoreWebView2_25

  • ICoreWebView2_25：：add_SaveAsUIShowing
  • ICoreWebView2_25：：remove_SaveAsUIShowing
  • ICoreWebView2_25：：顯示SaveAsUI

• ICoreWebView2SaveAsUIShowingEventHandler

• ICoreWebView2SaveAsUIShowingEventArgs

  • ICoreWebView2SaveAsUIShowingEventArgs：：get_AllowReplace
  • ICoreWebView2SaveAsUIShowingEventArgs：：get_Cancel
  • ICoreWebView2SaveAsUIShowingEventArgs：：get_ContentMimeType
  • ICoreWebView2SaveAsUIShowingEventArgs：：get_Kind
  • ICoreWebView2SaveAsUIShowingEventArgs：：get_SaveAsFilePath
  • ICoreWebView2SaveAsUIShowingEventArgs：：get_SuppressDefaultDialog
  • ICoreWebView2SaveAsUIShowingEventArgs：：GetDeferral
  • ICoreWebView2SaveAsUIShowingEventArgs：:p ut_AllowReplace
  • ICoreWebView2SaveAsUIShowingEventArgs：:p ut_Cancel
  • ICoreWebView2SaveAsUIShowingEventArgs：:p ut_Kind
  • ICoreWebView2SaveAsUIShowingEventArgs：:p ut_SaveAsFilePath
  • ICoreWebView2SaveAsUIShowingEventArgs：:p ut_SuppressDefaultDialog

• ICoreWebView2ShowSaveAsUICompletedHandler

• COREWEBVIEW2_SAVE_AS_KIND 列舉

  • COREWEBVIEW2_SAVE_AS_KIND_DEFAULT
  • COREWEBVIEW2_SAVE_AS_KIND_HTML_ONLY
  • COREWEBVIEW2_SAVE_AS_KIND_SINGLE_FILE
  • COREWEBVIEW2_SAVE_AS_KIND_COMPLETE

• COREWEBVIEW2_SAVE_AS_UI_RESULT 列舉

  • COREWEBVIEW2_SAVE_AS_UI_RESULT_SUCCESS
  • COREWEBVIEW2_SAVE_AS_UI_RESULT_INVALID_PATH
  • COREWEBVIEW2_SAVE_AS_UI_RESULT_FILE_ALREADY_EXISTS
  • COREWEBVIEW2_SAVE_AS_UI_RESULT_KIND_NOT_SUPPORTED
  • COREWEBVIEW2_SAVE_AS_UI_RESULT_CANCELLED

儲存檔案時設定安全警告

透過監聽事件 SaveFileSecurityCheckStarting ，應用程式可以在此事件註冊處理器，取得檔案路徑、檔名副檔名及文件來源 URI 資訊。 接著你可以套用自己的規則來執行以下動作：

• 允許儲存檔案時不會顯示預設的安全警告介面。
• 取消存錢。
• 建立自己的 UI 來管理執行時的檔案類型政策。

.NET/C#

• CoreWebView2 班：

  • CoreWebView2.SaveFileSecurityCheckStarting Event

• CoreWebView2SaveFileSecurityCheckStartingEventArgs 類別

  • CoreWebView2SaveFileSecurityCheckStartingEventArgs.CancelSave Property
  • CoreWebView2SaveFileSecurityCheckStartingEventArgs.DocumentOriginUri 屬性
  • CoreWebView2SaveFileSecurityCheckStartingEventArgs.FileExtension 屬性
  • CoreWebView2SaveFileSecurityCheckStartingEventArgs.FilePath Property
  • CoreWebView2SaveFileSecurityCheckStartingEventArgs.SuppressDefaultPolicy Property
  • CoreWebView2SaveFileSecurityCheckStartingEventArgs.GetDeferral Method

WinRT/C#

• CoreWebView2 班：

  • CoreWebView2.SaveFileSecurityCheckStarting Event

• CoreWebView2SaveFileSecurityCheckStartingEventArgs 類別

  • CoreWebView2SaveFileSecurityCheckStartingEventArgs.CancelSave Property
  • CoreWebView2SaveFileSecurityCheckStartingEventArgs.DocumentOriginUri 屬性
  • CoreWebView2SaveFileSecurityCheckStartingEventArgs.FileExtension 屬性
  • CoreWebView2SaveFileSecurityCheckStartingEventArgs.FilePath Property
  • CoreWebView2SaveFileSecurityCheckStartingEventArgs.SuppressDefaultPolicy Property
  • CoreWebView2SaveFileSecurityCheckStartingEventArgs.GetDeferral Method

Win32/C++

• ICoreWebView2_26

  • ICoreWebView2_26：：add_SaveFileSecurityCheckStarting
  • ICoreWebView2_26：：remove_SaveFileSecurityCheckStarting

• ICoreWebView2SaveFileSecurityCheckStartingEventArgs

  • ICoreWebView2SaveFileSecurityCheckStartingEventArgs：：get_CancelSave
  • ICoreWebView2SaveFileSecurityCheckStartingEventArgs：：get_DocumentOriginUri
  • ICoreWebView2SaveFileSecurityCheckStartingEventArgs：：get_FileExtension
  • ICoreWebView2SaveFileSecurityCheckStartingEventArgs：：get_FilePath
  • ICoreWebView2SaveFileSecurityCheckStartingEventArgs：：get_SuppressDefaultPolicy
  • ICoreWebView2SaveFileSecurityCheckStartingEventArgs：GetDeferral
  • ICoreWebView2SaveFileSecurityCheckStartingEventArgs：:p ut_cancelSave
  • ICoreWebView2SaveFileSecurityCheckStartingEventArgs：:p ut_SuppressDefaultPolicy

• ICoreWebView2SaveFileSecurityCheckStartingEventHandler

網頁通知處理

網頁通知 API 支援非持久性通知。 NotificationReceived該CoreWebView2事件控制網頁通知處理，允許主機應用程式進行自訂或抑制。 未處理的通知預設使用 WebView2 的介面。

.NET/C#

• CoreWebView2 班：

  • CoreWebView2.NotificationReceived 事件

• CoreWebView2Notification 類別

  • CoreWebView2Notification.BadgeUri 屬性
  • CoreWebView2Notification.Body 屬性
  • CoreWebView2Notification.BodyImageUri 屬性
  • CoreWebView2Notification.Direction 屬性
  • CoreWebView2Notification.IconUri 屬性
  • CoreWebView2Notification.IsSilent 屬性
  • CoreWebView2Notification.Language 屬性
  • CoreWebView2Notification.RequiresInteraction 屬性
  • CoreWebView2Notification.ShouldRenotify 屬性
  • CoreWebView2Notification.Tag 屬性
  • CoreWebView2Notification.Timestamp 屬性
  • CoreWebView2Notification.Title 屬性
  • CoreWebView2Notification.VibrationPattern 屬性
  • CoreWebView2Notification.ReportClicked 方法
  • CoreWebView2Notification.ReportClosed 方法
  • CoreWebView2Notification.ReportShown 方法
  • CoreWebView2Notification.CloseRequested Event

• CoreWebView2NotificationReceivedEventArgs 類別

  • CoreWebView2NotificationReceivedEventArgs.Handled 屬性
  • CoreWebView2NotificationReceivedEventArgs.Notification 屬性
  • CoreWebView2NotificationReceivedEventArgs.SenderOrigin 屬性
  • CoreWebView2NotificationReceivedEventArgs.GetDeferral 方法

• CoreWebView2TextDirectionKind 枚舉

  • Default
  • LeftToRight
  • RightToLeft

WinRT/C#

• CoreWebView2 班：

  • CoreWebView2.NotificationReceived 事件

• CoreWebView2Notification 類別

  • CoreWebView2Notification.BadgeUri 屬性
  • CoreWebView2Notification.Body 屬性
  • CoreWebView2Notification.BodyImageUri 屬性
  • CoreWebView2Notification.Direction 屬性
  • CoreWebView2Notification.IconUri 屬性
  • CoreWebView2Notification.IsSilent 屬性
  • CoreWebView2Notification.Language 屬性
  • CoreWebView2Notification.RequiresInteraction 屬性
  • CoreWebView2Notification.ShouldRenotify 屬性
  • CoreWebView2Notification.Tag 屬性
  • CoreWebView2Notification.Timestamp 屬性
  • CoreWebView2Notification.Title 屬性
  • CoreWebView2Notification.VibrationPattern 屬性
  • CoreWebView2Notification.ReportClicked 方法
  • CoreWebView2Notification.ReportClosed 方法
  • CoreWebView2Notification.ReportShown 方法
  • CoreWebView2Notification.CloseRequested Event

• CoreWebView2NotificationReceivedEventArgs 類別

  • CoreWebView2NotificationReceivedEventArgs.Handled 屬性
  • CoreWebView2NotificationReceivedEventArgs.Notification 屬性
  • CoreWebView2NotificationReceivedEventArgs.SenderOrigin 屬性
  • CoreWebView2NotificationReceivedEventArgs.GetDeferral 方法

• CoreWebView2TextDirectionKind 枚舉

  • Default
  • LeftToRight
  • RightToLeft

Win32/C++

• ICoreWebView2_24

  • ICoreWebView2_24：：add_NotificationReceived
  • ICoreWebView2_24：：remove_NotificationReceived

• ICoreWebView2通知

  • ICoreWebView2Notification：：add_CloseRequested
  • ICoreWebView2Notification：：get_BadgeUri
  • ICoreWebView2Notification：：get_Body
  • ICoreWebView2Notification：：get_BodyImageUri
  • ICoreWebView2Notification：：get_Direction
  • ICoreWebView2Notification：：get_IconUri
  • ICoreWebView2Notification：：get_IsSilent
  • ICoreWebView2Notification：：get_Language
  • ICoreWebView2Notification：：get_RequiresInteraction
  • ICoreWebView2Notification：：get_ShouldRenotify
  • ICoreWebView2Notification：：get_Tag
  • ICoreWebView2Notification：：get_Timestamp
  • ICoreWebView2Notification：：get_Title
  • ICoreWebView2Notification：：GetVibrationPattern
  • ICoreWebView2Notification：：remove_CloseRequested
  • ICoreWebView2通知：：報告點擊
  • ICoreWebView2通知：：報告已關閉
  • ICoreWebView2通知：：報告已顯示

• ICoreWebView2NotificationCloseRequestedEventHandler

• ICoreWebView2NotificationReceivedEventArgs

  • ICoreWebView2NotificationReceivedEventArgs：：get_Handled
  • ICoreWebView2NotificationReceivedEventArgs：：get_Notification
  • ICoreWebView2NotificationReceivedEventArgs：：get_SenderOrigin
  • ICoreWebView2NotificationReceivedEventArgs：：GetDeferral
  • ICoreWebView2NotificationReceivedEventArgs：:p ut_Handled

• ICoreWebView2NotificationReceivedEventHandler

• COREWEBVIEW2_TEXT_DIRECTION_KIND 列舉

  • COREWEBVIEW2_TEXT_DIRECTION_KIND_DEFAULT
  • COREWEBVIEW2_TEXT_DIRECTION_KIND_LEFT_TO_RIGHT
  • COREWEBVIEW2_TEXT_DIRECTION_KIND_RIGHT_TO_LEFT

權限

不同網頁可能會要求你取得某些特權資源的權限，例如地理定位感測器、攝影機和麥克風。 你的主機應用程式可以程式化回應權限請求，並能用自己的介面取代預設權限介面。

.NET/C#

• CoreWebView2 班：
  • CoreWebView2.PermissionRequested 事件
• CoreWebView2Frame 班：
  • CoreWebView2Frame.PermissionRequested Event
• CoreWebView2PermissionKind 枚舉
• CoreWebView2PermissionRequestedEventArgs 班：
  • CoreWebView2PermissionRequestedEventArgs.SavesInProfile Property
• CoreWebView2PermissionSetting 類別
  • CoreWebView2PermissionSetting.PermissionKind 屬性
  • CoreWebView2PermissionSetting.PermissionOrigin 屬性
  • CoreWebView2PermissionSetting.PermissionState 屬性
• CoreWebView2Profile 班：
  • CoreWebView2Profile.GetNonDefaultPermissionSettingsAsync 方法
  • CoreWebView2Profile.SetPermissionStateAsync 方法

WinRT/C#

• CoreWebView2 班：
  • CoreWebView2.PermissionRequested 事件
• CoreWebView2Frame 班：
  • CoreWebView2Frame.PermissionRequested Event
• CoreWebView2PermissionKind 枚舉
• CoreWebView2PermissionRequestedEventArgs 班：
  • CoreWebView2PermissionRequestedEventArgs.SavesInProfile Property
• 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 方法
• ICoreWebView2PermissionSetting集合檢視介面
  • ICoreWebView2PermissionSettingCollectionView：：GetValueAtIndex 方法。
  • ICoreWebView2PermissionSettingCollectionView：：get_Count 方法
• ICoreWebView2Profile4 界面：
  • ICoreWebView2Profile4：：GetNonDefaultPermissionSettings 方法。
  • ICoreWebView2Profile4：：SetPermissionState 方法
• ICoreWebView2SetPermissionStateCompletedHandler 介面
• COREWEBVIEW2_PERMISSION_KIND枚舉

快顯功能表

WebView2 控制項提供預設的右鍵選單 (右鍵選單) ，你可以自訂或停用，也可以建立自己的右鍵選單。

另請參閱:

• 在 WebView2 中自訂上下文選單

.NET/C#

• CoreWebView2 班：
  • CoreWebView2.ContextMenuRequested Event
• CoreWebView2ContextMenuItem 類別
• CoreWebView2ContextMenuRequestedEventArgs 類別
• CoreWebView2ContextMenuTarget 類別
• CoreWebView2Environment 班：
  • CoreWebView2Environment.CreateContextMenuItem 方法
• CoreWebView2Settings 班：
  • CoreWebView2Settings.AreDefaultContextMenusEnabled プロパティ

WinRT/C#

• CoreWebView2 班：
  • CoreWebView2.ContextMenuRequested Event
• 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

流暢疊加捲軸條

以 Microsoft Fluent 設計風格化捲軸，並讓捲軸重疊在網頁內容上。 這種自適應滾動條設計會根據不同裝置和視窗大小調整。

要嘗試 Fluent 疊加捲軸，請在 Microsoft Edge 中進入 edge://flags 並進入 Fluent 疊加捲軸。

另請參閱:

• WebView2 瀏覽器標記 - msEdgeFluentOverlayScrollbar 還有 msOverlayScrollbarWinStyle 旗幟。

.NET/C#

• CoreWebView2EnvironmentOptions 班：

  • CoreWebView2EnvironmentOptions.ScrollBarStyle 屬性

• CoreWebView2ScrollbarStyle 列舉

  • Default
  • FluentOverlay

WinRT/C#

• CoreWebView2EnvironmentOptions 班：

  • CoreWebView2EnvironmentOptions.ScrollBarStyle 屬性

• CoreWebView2ScrollbarStyle 列舉

  • Default
  • FluentOverlay

Win32/C++

• ICoreWebView2EnvironmentOptions8

  • ICoreWebView2EnvironmentOptions8：：get_ScrollBarStyle
  • ICoreWebView2EnvironmentOptions8：:p ut_ScrollBarStyle

• 列舉COREWEBVIEW2_SCROLLBAR_STYLE

  • COREWEBVIEW2_SCROLLBAR_STYLE_DEFAULT
  • COREWEBVIEW2_SCROLLBAR_STYLE_FLUENT_OVERLAY

使用者代理程式

使用者代理是一個字串，代表使用者代表程式的身份，例如瀏覽器名稱。 在 WebView2 中，你可以設定使用者代理。

另請參閱:

• 利用 User-Agent 用戶端提示偵測Windows 11與 CPU 架構
• 覆寫使用者代理字串

.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.Ismutted 屬性

WinRT/C#

• CoreWebView2 班：
  • CoreWebView2.IsDocumentPlayingAudioChanged 事件
  • CoreWebView2.IsMutedChanged 事件
  • CoreWebView2.IsDocumentPlayingAudio 屬性
  • CoreWebView2.Ismutted 屬性

Win32/C++

• ICoreWebView2_8 界面：
  • ICoreWebView2_8：：add_IsDocumentPlayingAudioChanged 方法
  • ICoreWebView2_8：：add_IsMutedChanged方法
  • ICoreWebView2_8：：get_IsDocumentPlayingAudio方法
  • ICoreWebView2_8：：get_IsMuted方法
  • ICoreWebView2_8：:p ut_Ismutted 方法
  • ICoreWebView2_8：：remove_IsDocumentPlayingAudioChanged 方法
  • ICoreWebView2_8：：remove_IsMutedChanged 方法

地區滑鼠點擊的測試

提供 WebView2 所包含區域的碰撞測試結果。 對於想處理 WebView2 視窗非客戶端區域滑鼠事件的視覺化託管應用程式非常有用。

.NET/C#

• CoreWebView2CompositionController 班：

  • CoreWebView2CompositionController.GetNonClientRegionAtPoint Method
  • CoreWebView2CompositionController.NonClientRegionChanged Event
  • CoreWebView2CompositionController.QueryNonClientRegion Method

• CoreWebView2NonClientRegionChangedEventArgs 班：

  • CoreWebView2NonClientRegionChangedEventArgs.RegionKind Property

• CoreWebView2NonClientRegionKind Enum

  • Caption
  • Client
  • Nowhere

• CoreWebView2Settings 班：

  • CoreWebView2Settings.IsNonClientRegionSupportEnabled 屬性

WinRT/C#

• CoreWebView2CompositionController 班：

  • CoreWebView2CompositionController.GetNonClientRegionAtPoint Property
  • CoreWebView2CompositionController.NonClientRegionChanged Event
  • CoreWebView2CompositionController.QueryNonClientRegion Property

• CoreWebView2NonClientRegionChangedEventArgs 班：

  • CoreWebView2NonClientRegionChangedEventArgs.RegionKind Property

• CoreWebView2NonClientRegionKind Enum

  • 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 Property

WinRT/C#

• CoreWebView2AcceleratorKeyPressedEventArgs 班：
  • CoreWebView2AcceleratorKeyPressedEventArgs.IsBrowserAcceleratorKeyEnabled Property

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 預設顯示語言，適用於瀏覽器介面 (，例如上下文選單和對話框) ，並設定 accept-language WebView2 傳送給網站的 HTTP 標頭。

此 ScriptLocale 屬性允許主機應用程式設定所有 Intl JavaScript API 及其他依賴它的 JavaScript API 的預設位置，例如 Intl.DateTimeFormat()，這會影響時間/日期格式的字串格式。

.NET/C#

• CoreWebView2EnvironmentOptions 班：
  • CoreWebView2EnvironmentOptions.Language 屬性
• CoreWebView2ControllerOptions 班：
  • CoreWebView2ControllerOptions.ScriptLocale Property

WinRT/C#

• CoreWebView2EnvironmentOptions 班：
  • CoreWebView2EnvironmentOptions.Language 屬性
• CoreWebView2ControllerOptions 班：
  • CoreWebView2ControllerOptions.ScriptLocale Property

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 Event
• CoreWebView2NewWindowRequestedEventArgs Class
• CoreWebView2WindowFeatures 類別

WinRT/C#

• CoreWebView2 班：
  • CoreWebView2.NewWindowRequested Event
• CoreWebView2NewWindowRequestedEventArgs Class
• CoreWebView2WindowFeatures 類別

Win32/C++

• ICoreWebView2 界面：
  • ICoreWebView2：：add_NewWindowRequested 方法
  • ICoreWebView2：：remove_NewWindowRequested方法
• ICoreWebView2NewWindowRequestedEventArgs 介面
• ICoreWebView2WindowFeatures 介面

關閉視窗

WebView2 提供處理 JavaScript 函式 window.close()的功能。

.NET/C#

• CoreWebView2 班：
  • CoreWebView2.WindowCloseRequested Event
• CoreWebView2Controller 班：
  • CoreWebView2Controller.Close 方法

WinRT/C#

• CoreWebView2 班：
  • CoreWebView2.WindowCloseRequested Event
• 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

智慧螢幕

Microsoft Defender SmartScreen (「SmartScreen」) 預設是啟用的。 屬性控制 IsReputationCheckingRequired 是否啟用 SmartScreen。

若您未停用 SmartScreen，您必須通知所有使用者您的軟體包含 Microsoft Defender SmartScreen，並依據 Microsoft 隱私聲明及 SmartScreen 中 Microsoft Edge 的用戶資料與隱私條款，收集並傳送使用者資訊給 Microsoft。

另請參閱:

• SmartScreen 在 資料中，在 WebView2 中取得隱私。

.NET/C#

• CoreWebView2Settings 班：
  • CoreWebView2Settings.IsReputationCheckingRequired Property

WinRT/C#

• CoreWebView2Settings 班：
  • CoreWebView2Settings.IsReputationCheckingRequired Property

Win32/C++

• ICoreWebView2Settings8 界面：
  • ICoreWebView2Settings8：：get_IsReputationCheckingRequired方法
  • ICoreWebView2Settings8：:p ut_IsReputationCheckingRequired 方法

自訂崩潰報告

如果任何 WebView2 程序當機，會建立一個或多個 minidump 檔案並送交 Microsoft 進行診斷。 使用此 API 在執行診斷和分析時自訂當機報告。

• 為了防止崩潰傾印資料傳送給 Microsoft，請將屬性 IsCustomCrashReportingEnabled 設為 false。
• 要找到崩潰傾倒並進行自訂，請使用該 CrashDumpFolderPath 屬性。

另請參閱:

• Data 中的自訂崩潰報告與 WebView2 的隱私保護。
• 迷你傾倒檔案

.NET/C#

• CoreWebView2EnvironmentOptions 班：
  • CoreWebView2EnvironmentOptions.IsCustomCrashReportingEnabled 屬性
• CoreWebView2Environment 班：
  • CoreWebView2Environment.FailureReportFolderPath 屬性

WinRT/C#

• CoreWebView2EnvironmentOptions 班：
  • CoreWebView2EnvironmentOptions.IsCustomCrashReportingEnabled 屬性
• CoreWebView2Environment 班：
  • CoreWebView2Environment.FailureReportFolderPath 屬性

Win32/C++

• ICoreWebView2EnvironmentOptions3 界面：
  • ICoreWebView2EnvironmentOptions3：：get_IsCustomCrashReportingEnabled
  • ICoreWebView2EnvironmentOptions3：:p ut_IsCustomCrashReportingEnabled
• ICoreWebView2Environment11 界面：
  • ICoreWebView2Environment11：：get_FailureReportFolderPath

瀏覽器擴充功能

你的應用程式可以嵌入使用 Microsoft Edge 擴充功能的 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 Class
• CoreWebView2Environment 班：
  • CoreWebView2Environment.GetProcessInfos 方法
  • CoreWebView2Environment.BrowserProcessExited Event
  • CoreWebView2Environment.ProcessInfosChanged 事件
• CoreWebView2ProcessFailedEventArgs Class
• CoreWebView2ProcessFailedKind Enum
• CoreWebView2ProcessFailedReason Enum
• CoreWebView2ProcessInfo 類別

WinRT/C#

• CoreWebView2 班：
  • CoreWebView2.BrowserProcessId 屬性
  • CoreWebView2.ProcessFailed 事件
• CoreWebView2BrowserProcessExitedEventArgs Class
• CoreWebView2Environment 班：
  • CoreWebView2Environment.GetProcessInfos 方法
  • CoreWebView2Environment.BrowserProcessExited Event
  • CoreWebView2Environment.ProcessInfosChanged 事件
• CoreWebView2ProcessFailedEventArgs Class
• CoreWebView2ProcessFailedKind Enum
• CoreWebView2ProcessFailedReason Enum
• CoreWebView2ProcessInfo 類別

Win32/C++

• ICoreWebView2 界面：
  • ICoreWebView2：：add_ProcessFailed
  • ICoreWebView2：：get_BrowserProcessId
  • ICoreWebView2：：remove_ProcessFailed
• ICoreWebView2BrowserProcessExitedEventArgs
• ICoreWebView2Environment5 界面：
  • ICoreWebView2Environment5：：add_BrowserProcessExited
  • ICoreWebView2Environment5：：remove_BrowserProcessExited
• ICoreWebView2Environment8 界面：
  • ICoreWebView2Environment8：：取得流程資訊
  • ICoreWebView2Environment8：：add_ProcessInfosChanged
  • ICoreWebView2Environment8：：remove_ProcessInfosChanged
• ICoreWebView2ProcessFailedEventArgs
• ICoreWebView2ProcessFailedEventArgs2
• ICoreWebView2ProcessFailedEventArgs3
• ICoreWebView2ProcessInfo
• ICoreWebView2ProcessInfoCollection
• 列舉COREWEBVIEW2_PROCESS_FAILED_KIND
• COREWEBVIEW2_PROCESS_FAILED_REASON枚舉

框架工藝資訊

Frame Process Info 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 Enum

瀏覽頁面並管理已載入的內容

透過 WebView2 控制，您的應用程式可以管理網頁導覽及網頁中載入的內容。

管理載入於 WebView2 的內容

這些 API 會載入、停止載入，並重新載入內容到 WebView2。 載入的內容可以是：

• 來自網址的內容。
• 一串 HTML 文件。
• 透過虛擬主機名稱將本地內容映射到本地資料夾。
• 來自建構網路請求的內容。

另請參閱:

• 在 WebView2 應用程式中使用本地內容

.NET/C#

• CoreWebView2 班：
  • CoreWebView2.ClearVirtualHostNameToFolderMapping 方法
  • CoreWebView2.Navigate 方法
  • CoreWebView2.NavigateToString 方法
  • CoreWebView2.NavigateWithWebResourceRequest 方法
  • CoreWebView2.Reload 方法
  • CoreWebView2.SetVirtualHostNameToFolderMapping Method
  • CoreWebView2.Stop 方法
  • CoreWebView2.WebResourceRequested Event
• CoreWebView2Settings 班：
  • CoreWebView2Settings.IsBuiltInErrorPageEnabled 屬性

WinRT/C#

• CoreWebView2 班：
  • CoreWebView2.ClearVirtualHostNameToFolderMapping 方法
  • CoreWebView2.Navigate 方法
  • CoreWebView2.NavigateToString 方法
  • CoreWebView2.NavigateWithWebResourceRequest 方法
  • CoreWebView2.Reload 方法
  • CoreWebView2.SetVirtualHostNameToFolderMapping Method
  • CoreWebView2.Stop 方法
  • CoreWebView2.WebResourceRequested Event
• CoreWebView2Settings 班：
  • CoreWebView2Settings.IsBuiltInErrorPageEnabled 屬性

Win32/C++

• ICoreWebView2 界面：
  • ICoreWebView2：：add_WebResourceRequested方法
  • ICoreWebView2：：remove_WebResourceRequested 方法
  • ICoreWebView2：：Navigate 方法。
  • ICoreWebView2：：NavigateToString 方法
  • ICoreWebView2：：Reload 方法
  • ICoreWebView2：：停止方法（Stop method）
• 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 中指定網址的導航，包括框架。

.NET/C#

• CoreWebView2 班：
  • CoreWebView2.NavigationStarting Event
  • CoreWebView2.FrameNavigationStarting Event - 已取代;代用CoreWebView2Frame.NavigationStarting
• CoreWebView2Frame 班：
  • CoreWebView2Frame.NavigationStarting Event
• CoreWebView2NavigationStartingEventArgs 類別

WinRT/C#

• CoreWebView2 班：
  • CoreWebView2.NavigationStarting Event
  • CoreWebView2.FrameNavigationStarting Event - 已取代;代用CoreWebView2Frame.NavigationStarting
• CoreWebView2Frame 班：
  • CoreWebView2Frame.NavigationStarting Event
• 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 中的導航狀態。 導航是載入新網址的過程。

另請參閱:

• WebView2 應用程式的導覽事件

.NET/C#

• CoreWebView2 班：
  • CoreWebView2.ContentLoading Event
  • CoreWebView2.DOMContentLoaded Event
  • CoreWebView2.FrameNavigationCompleted事件 - 已取代; CoreWebView2Frame.NavigationCompleted 用吧。
  • CoreWebView2.導覽已完成活動
• CoreWebView2ContentLoadingEventArgs 類別
• CoreWebView2DOMContentLoadedEventArgs Class
• CoreWebView2Frame 班：
  • CoreWebView2Frame.ContentLoading 事件
  • CoreWebView2Frame.DOMContentLoaded Event
  • CoreWebView2Frame.NavigationCompletedEvent（已完成）
• CoreWebView2NavigationCompletedEventArgs 類別

WinRT/C#

• CoreWebView2 班：
  • CoreWebView2.ContentLoading Event
  • CoreWebView2.DOMContentLoaded Event
  • CoreWebView2.FrameNavigationCompleted事件 - 已取代; CoreWebView2Frame.NavigationCompleted 用吧。
  • CoreWebView2.導覽已完成活動
• CoreWebView2ContentLoadingEventArgs 類別
• CoreWebView2DOMContentLoadedEventArgs Class
• CoreWebView2Frame 班：
  • CoreWebView2Frame.ContentLoading 事件
  • CoreWebView2Frame.DOMContentLoaded Event
  • CoreWebView2Frame.NavigationCompletedEvent（已完成）
• 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 Method
  • CoreWebView2.RemoveWebResourceRequestedFilter Method
  • CoreWebView2.WebResourceRequested Event
  • CoreWebView2.WebResourceResponseReceived 事件

• CoreWebView2WebResourceRequestedEventArgs Class

• CoreWebView2WebResourceRequestSourceKinds Enum

• CoreWebView2WebResourceResponseReceivedEventArgs 類別

WinRT/C#

• CoreWebView2 班：

  • CoreWebView2.AddWebResourceRequestedFilter Method
  • CoreWebView2.RemoveWebResourceRequestedFilter Method
  • CoreWebView2.WebResourceRequested Event
  • CoreWebView2.WebResourceResponseReceived 事件

• CoreWebView2WebResourceRequestedEventArgs Class

• CoreWebView2WebResourceRequestSourceKinds Enum

• CoreWebView2WebResourceResponseReceivedEventArgs 類別

Win32/C++

• ICoreWebView2:

  • ICoreWebView2：：add_WebResourceRequested
  • ICoreWebView2：：remove_WebResourceRequested

• ICoreWebView2_2

  • ICoreWebView2_2：：add_WebResourceResponseReceived
  • ICoreWebView2_2：：remove_WebResourceResponseReceived

• ICoreWebView2_22

  • ICoreWebView2_22：：AddWebResourceRequestedFilterWithRequestSourceTypes
  • ICoreWebView2_22：：RemoveWebResourceRequestedFilterWithRequestSourceKinds

• ICoreWebView2WebResourceRequestedEventArgs

• ICoreWebView2WebResourceRequestedEventArgs2

  • ICoreWebView2WebResourceRequestedEventArgs2：：get_RequestedSourceKind

• ICoreWebView2WebResourceResponseReceivedEventArgs

• COREWEBVIEW2_WEB_RESOURCE_REQUEST_SOURCE_KINDS枚舉

自訂方案註冊

它 CustomSchemeRegistration 允許在 WebView2 中註冊自訂方案，讓應用程式能處理 WebResourceRequested 對這些自訂方案 URL 的請求事件，並透過 WebView2 導航到這些網址。

.NET/C#

• CoreWebView2CustomSchemeRegistration 類別
• CoreWebView2EnvironmentOptions 班：
  • CoreWebView2EnvironmentOptions.CustomSchemeRegistrations 屬性

WinRT/C#

• CoreWebView2CustomSchemeRegistration 類別
• CoreWebView2EnvironmentOptions 班：
  • CoreWebView2EnvironmentOptions.CustomSchemeRegistrations 屬性

Win32/C++

• ICoreWebView2CustomSchemeRegistration 介面
• ICoreWebView2EnvironmentOptions4 界面：
  • ICoreWebView2EnvironmentOptions4：：GetCustomSchemeRegistrations 方法
  • ICoreWebView2EnvironmentOptions4：：SetCustomSchemeRegistrations 方法

用戶端憑證

在 WebView2 中，你可以使用 Client Certificate API 在應用程式層級選擇客戶端憑證。 此 API 允許您：

• 如果需要，可以顯示使用者介面。
• 替換預設的客戶憑證對話框提示。
• 用程式化方式查詢證書。
• 當 WebView2 向需要客戶端憑證的 HTTP 伺服器發出請求時，從清單中選擇一個憑證來回應伺服器。

.NET/C#

• CoreWebView2 班：
  • CoreWebView2.ClientCertificateRequested Event
• CoreWebView2ClientCertificate 類別
• CoreWebView2ClientCertificateRequestedEventArgs Class

WinRT/C#

• CoreWebView2 班：
  • CoreWebView2.ClientCertificateRequested Event
• CoreWebView2ClientCertificate 類別
• CoreWebView2ClientCertificateRequestedEventArgs Class

Win32/C++

• ICoreWebView2_5 界面：
  • ICoreWebView2_5：：add_ClientCertificateRequested方法
  • ICoreWebView2_5：：remove_ClientCertificateRequested 方法
• ICoreWebView2ClientCertificate 介面
• ICoreWebView2ClientCertificateCollection 介面
• ICoreWebView2ClientCertificateRequestedEventArgs 介面

伺服器憑證

在 WebView2 中，你可以使用伺服器憑證 API，在應用程式層級信任伺服器的 TLS 憑證。 這樣一來，你的主機應用程式就能在不提醒使用者 TLS 錯誤的情況下渲染頁面，或者主機應用程式能自動取消請求。

.NET/C#

• CoreWebView2 班：
  • CoreWebView2.ServerCertificateErrorDetected Event
  • CoreWebView2.ClearServerCertificateErrorActionsAsync 方法

WinRT/C#

• CoreWebView2 班：
  • CoreWebView2.ServerCertificateErrorDetected Event
  • CoreWebView2.ClearServerCertificateErrorActionsAsync 方法

Win32/C++

• ICoreWebView2_14 界面：
  • ICoreWebView2_14：：add_ServerCertificateErrorDetected方法
  • ICoreWebView2_14：：remove_ServerCertificateErrorDetected方法
  • ICoreWebView2_14：：ClearServerCertificateErrorActions 方法

啟動外部 URI 方案

啟動一個已註冊於作業系統的 URI 方案。

.NET/C#

• CoreWebView2 班：
  • CoreWebView2.LaunchingExternalUriScheme Event
• CoreWebView2LaunchingExternalUriSchemeEventArgs Class
  • CoreWebView2LaunchingExternalUriSchemeEventArgs.Cancel Property
  • CoreWebView2LaunchingExternalUriSchemeEventArgs.InitiatingOrigin 屬性
  • CoreWebView2LaunchingExternalUriSchemeEventArgs.IsUserInitiated Property
  • CoreWebView2LaunchingExternalUriSchemeEventArgs.Uri Property
  • CoreWebView2LaunchingExternalUriSchemeEventArgs.GetDeferral 方法

WinRT/C#

• CoreWebView2 班：
  • CoreWebView2.LaunchingExternalUriScheme Event
• CoreWebView2LaunchingExternalUriSchemeEventArgs Class
  • CoreWebView2LaunchingExternalUriSchemeEventArgs.Cancel Property
  • CoreWebView2LaunchingExternalUriSchemeEventArgs.InitiatingOrigin 屬性
  • CoreWebView2LaunchingExternalUriSchemeEventArgs.IsUserInitiated Property
  • CoreWebView2LaunchingExternalUriSchemeEventArgs.Uri Property
  • CoreWebView2LaunchingExternalUriSchemeEventArgs.GetDeferral Property

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-frame 選項。

另請參閱:

• 主機/網頁物件共享，如上所述
• 在 WebView2 應用程式中使用框架
• 在 WebView2 SDK 的 Archived 發佈說明中追蹤巢狀 iframes (FrameCreatedEvent API) 的導航歷史。

.NET/C#

• CoreWebView2 班：

  • CoreWebView2.FrameCreated 事件

• CoreWebView2Frame 類別

  • CoreWebView2Frame.FrameCreated 事件

• CoreWebView2FrameCreatedEventArgs 類別

• CoreWebView2FrameInfo 類別

WinRT/C#

• CoreWebView2 班：

  • CoreWebView2.FrameCreated 事件

• CoreWebView2Frame 類別

  • CoreWebView2Frame.FrameCreated 事件

• CoreWebView2FrameCreatedEventArgs 類別

• CoreWebView2FrameInfo 類別

Win32/C++

• ICoreWebView2_4 界面：

  • ICoreWebView2_4：：add_FrameCreated
  • ICoreWebView2_4：：remove_FrameCreated

• ICoreWebView2Frame

• ICoreWebView2Frame7

  • ICoreWebView2Frame7：：add_FrameCreated
  • ICoreWebView2Frame7：：remove_FrameCreated

• ICoreWebView2FrameChildFrameCreatedEventHandler

• 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 框架，也沒有使用 Composition ——例如，如果你沒有為應用程式 (使用介面框架，或是直接) 使用純 Win32，或是你的 UI 框架沒有 WebView2 元素，那麼你需要用本節的 API 來建立 CoreWebView2Controller 並渲染它到你的應用程式中。

• 沒有 UI 框架，且使用 Composition - 如果你的應用程式 UI 是使用 DirectComposition 或 Windows.UI.Composition 建置，建議使用 CoreWebView2CompositionController 而非使用這些 API;詳見下方 「使用 Composition 渲染 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 的可見性可以透過 切換 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 用於縮放視窗的網頁內容。 使用者在旋轉滑鼠滾輪時按 Ctrl 縮放內容時，UI 縮放也會同步。

.NET/C#

• CoreWebView2Controller 班：
  • CoreWebView2Controller.ZoomFactor 屬性
  • CoreWebView2Controller.ZoomFactorChanged Event
  • CoreWebView2Controller.SetBoundsAndZoomFactor 方法
• CoreWebView2Settings 班：
  • CoreWebView2Settings.IsPinchZoomEnabled 屬性
  • CoreWebView2Settings.IsZoomControlEnabled 屬性

WinRT/C#

• CoreWebView2Controller 班：
  • CoreWebView2Controller.ZoomFactor 屬性
  • CoreWebView2Controller.ZoomFactorChanged Event
  • 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 介面，包括右鍵選單、提示與彈出視窗。 該應用程式可設定 WebView2 是否偵測螢幕比例變化，並自動更新 RasterizationScale。 BoundsMode 用來設定界限屬性是被解讀為原始像素，還是需要按) 縮放 RasterizationScale 的 DIP (。

.NET/C#

• CoreWebView2Controller 班：
  • CoreWebView2Controller.BoundsMode 屬性
  • CoreWebView2Controller.RasterizationScale 屬性
  • CoreWebview2Controller.RasterizationScaleChanged Event
  • CoreWebview2Controller.ShouldDetectMonitorScaleChanges 屬性

WinRT/C#

• CoreWebView2Controller 班：
  • CoreWebView2Controller.BoundsMode 屬性
  • CoreWebView2Controller.RasterizationScale 屬性
  • CoreWebview2Controller.RasterizationScaleChanged Event
  • 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 鍵 () 時，有 API 可以將焦點移到 WebView2，WebView2 則有事件請求應用程式重新聚焦。

.NET/C#

• CoreWebview2Controller 班：
  • CoreWebview2Controller.GotFocus 事件
  • CoreWebview2Controller.LostFocus 事件
  • CoreWebview2Controller.MoveFocus 方法
  • CoreWebview2Controller.MoveFocusRequested Event
• CoreWebView2MoveFocusRequestedEventArgs Class

WinRT/C#

• CoreWebview2Controller 班：
  • CoreWebview2Controller.GotFocus 事件
  • CoreWebview2Controller.LostFocus 事件
  • CoreWebview2Controller.MoveFocus 方法
  • CoreWebview2Controller.MoveFocusRequested Event
• CoreWebView2MoveFocusRequestedEventArgs Class

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 Event
• CoreWebView2Settings 班：
  • CoreWebView2Settings.AreBrowserAcceleratorKeysEnabled Property

WinRT/C#

• CoreWebView2AcceleratorKeyPressedEventArgs 類別
• CoreWebView2Controller 班：
  • CoreWebView2Controller.AcceleratorKeyPressed Event
• CoreWebView2Settings 班：
  • CoreWebView2Settings.AreBrowserAcceleratorKeysEnabled Property

Win32/C++

• ICoreWebView2AcceleratorKeyPressedEventArgs 介面
• ICoreWebView2Controller 界面：
  • ICoreWebView2Controller：：add_AcceleratorKeyPressed方法
  • ICoreWebView2Controller：：remove_AcceleratorKeyPressed方法
• ICoreWebView2Settings3 界面：
  • ICoreWebView2Settings3：：get_AreBrowserAcceleratorKeysEnabled 方法
  • ICoreWebView2Settings3：:p ut_AreBrowserAcceleratorKeysEnabled 方法

預設背景色

WebView2 可以指定預設背景色。 顏色可以是任何不透明的，也可以是透明的。 如果 HTML 頁面沒有設定自己的背景色，這個顏色就會被使用。

另請參閱:

• 在 WebView2 SDK 的發行說明中 (DefaultBackgroundColor API) 設定 WebView2 初始化時的預設背景色。

.NET/C#

• CoreWebView2Controller 班：

  • CoreWebView2Controller.DefaultBackgroundColor 屬性

• CoreWebView2ControllerOptions 班：

  • CoreWebView2ControllerOptions.DefaultBackgroundColor 屬性

WinRT/C#

• CoreWebView2Controller 班：

  • CoreWebView2Controller.DefaultBackgroundColor 屬性

• CoreWebView2ControllerOptions 班：

  • CoreWebView2ControllerOptions.DefaultBackgroundColor 屬性

Win32/C++

• ICoreWebView2Controller2 界面：

  • ICoreWebView2Controller2：：get_DefaultBackgroundColor
  • ICoreWebView2Controller2：:p ut_DefaultBackgroundColor

• ICoreWebView2ControllerOptions3

  • ICoreWebView2ControllerOptions3：：get_DefaultBackgroundColor
  • ICoreWebView2ControllerOptions3：:p ut_DefaultBackgroundColor（預設背景色）

使用合成來渲染 WebView2

對於基於合成的 WebView2 渲染，請使用 CoreWebView2Environment 來建立一個 CoreWebView2CompositionController。 CoreWebView2CompositionController 提供與 CoreWebView2Controller相同的 API，但也包含基於組合的渲染 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 Property

WinRT/C#

• CoreWebView2CompositionController 班：
  • CoreWebView2CompositionController.RootVisualTarget Property

Win32/C++

• ICoreWebView2CompositionController 界面：
  • ICoreWebView2CompositionController：：get_RootVisualTarget方法
  • ICoreWebView2CompositionController：:p ut_RootVisualTarget method

轉發輸入

應用程式會接收滑鼠、觸控、筆觸 () 等空間輸入，並必須傳送至 WebView2。 WebView2 會根據滑鼠位置通知應用程式何時需要更新游標。

.NET/C#

• CoreWebView2CompositionController 班：
  • CoreWebView2CompositionController.游標屬性
  • CoreWebView2CompositionController.CursorChanged Event
  • CoreWebView2CompositionController.SystemCursorId Property
  • CoreWebView2CompositionController.SendMouseInput Method
  • CoreWebView2CompositionController.SendPointerInput Method
• CoreWebView2Environment 班：
  • CoreWebView2Environment.CreateCoreWebView2PointerInfo 方法
• CoreWebView2PointerInfo 類別

WinRT/C#

• CoreWebView2CompositionController 班：
  • CoreWebView2CompositionController.游標屬性
  • CoreWebView2CompositionController.CursorChanged Event
  • CoreWebView2CompositionController.SendMouseInput Method
  • CoreWebView2CompositionController.SendPointerInput Method
• CoreWebView2Environment 班：
  • CoreWebView2Environment.CreateCoreWebView2PointerInfo 方法
• CoreWebView2PointerInfo 類別

Win32/C++

• CoreWebView2CompositionController 界面：
  • ICoreWebView2CompositionController：：get_Cursor方法
  • ICoreWebView2CompositionController：：add_CursorChanged方法
  • ICoreWebView2CompositionController：：remove_CursorChanged方法
  • ICoreWebView2CompositionController：：get_SystemCursorId方法
  • ICoreWebView2CompositionController：：SendMouse輸入法
  • ICoreWebView2CompositionController：：SendPointer輸入法
• ICoreWebView2Environment3 界面：
  • ICoreWebView2Environment3：：CreateCoreWebView2PointerInfo 方法
• ICoreWebView2PointerInfo 介面

允許輸入事件訊息通過瀏覽器視窗

允許使用者輸入事件訊息 (鍵盤、滑鼠、觸控或筆) 的訊息透過瀏覽器視窗傳遞，並由應用程式的程序視窗接收。

.NET/C#

• CoreWebView2ControllerOptions 班：
  • CoreWebView2ControllerOptions.AllowHostInputProcessing 屬性

WinRT/C#

• CoreWebView2ControllerOptions 班：
  • CoreWebView2ControllerOptions.AllowHostInputProcessing 屬性

Win32/C++

• ICoreWebView2ControllerOptions4
  • ICoreWebView2ControllerOptions4：：get_AllowHostInputProcessing
  • ICoreWebView2ControllerOptions4：:p ut_AllowHostInputProcessing

拖放

預設支援從 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 method

環境選項

使用者資料

管理使用者資料資料夾 (UDF) ，這是使用者機器上的一個資料夾。 UDF 包含與主機應用程式及 WebView2 相關的資料。 WebView2 應用程式使用使用者資料資料夾來儲存瀏覽器資料，例如 Cookie、權限和快取資源。

另請參閱:

• 管理使用者資料資料夾
• 清除使用者資料資料夾中的瀏覽資料

.NET/C#

• CoreWebView2Environment 班：
  • CoreWebView2Environment.CreateCoreWebView2CompositionControllerAsync 方法
  • CoreWebView2Environment.CreateCoreWebView2ControllerOptions 方法
  • CoreWebView2Environment.CreateCoreWebView2ControllerWithOptions Method
  • CoreWebView2Environment.UserDataFolder 屬性
• CoreWebView2EnvironmentOptions 班：
  • CoreWebView2EnvironmentOptions.ExclusiveUserDataFolderAccess Property

清除瀏覽資料：

• CoreWebView2Profile 班：
  • CoreWebView2Profile.ClearBrowsingDataAsync 方法
• CoreWebView2BrowsingDataKinds Enum

WinRT/C#

• CoreWebView2Environment 班：
  • CoreWebView2Environment.CreateCoreWebView2CompositionControllerAsync 方法
  • CoreWebView2Environment.CreateCoreWebView2ControllerAsync 方法
  • CoreWebView2Environment.CreateCoreWebView2ControllerAsync (options) Method
  • CoreWebView2Environment.CreateCoreWebView2ControllerOptions 方法
  • CoreWebView2Environment.UserDataFolder 屬性
• CoreWebView2EnvironmentOptions 班：
  • CoreWebView2EnvironmentOptions.ExclusiveUserDataFolderAccess Property

清除瀏覽資料：

• CoreWebView2Profile 班：
  • CoreWebView2Profile.ClearBrowsingDataAsync 方法
• CoreWebView2BrowsingDataKinds Enum

Win32/C++

• ICoreWebView2Environment7 界面：
  • ICoreWebView2Environment7：：get_UserDataFolder方法
• ICoreWebView2Environment10 界面：
  • ICoreWebView2Environment10：：CreateCoreWebView2CompositionControllerWithOptions 方法
  • ICoreWebView2Environment10：：CreateCoreWebView2ControllerOptions 方法
  • ICoreWebView2Environment10：：CreateCoreWebView2ControllerWithOptions method
• ICoreWebView2EnvironmentOptions2 界面：
  • ICoreWebView2EnvironmentOptions2：：get_ExclusiveUserDataFolderAccess方法
  • ICoreWebView2EnvironmentOptions2：:p ut_ExclusiveUserDataFolderAccess method

清除瀏覽資料：

• ICoreWebView2Profile2 界面：
  • ICoreWebView2Profile2：：ClearBrowsingData 方法。
  • ICoreWebView2Profile2：：ClearBrowsingDataAll 方法
  • ICoreWebView2Profile2：：ClearBrowsingDataInTimeRange 方法
• COREWEBVIEW2_BROWSING_DATA_KINDS列舉

多重設定檔

在單一使用者資料資料夾下管理多個設定檔。

另請參閱:

• 支援多個使用者資料資料夾下的設定檔

.NET/C#

建立一個定義設定檔的選項物件：

• CoreWebView2Environment 班：
  • CoreWebView2Environment.CreateCoreWebView2ControllerOptions 方法
• CoreWebView2ControllerOptions 類別

建立一個 WebView2 控制項，使用以下設定檔：

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

存取並操作該檔案：

• CoreWebView2 班：
  • CoreWebView2.Profile 屬性
• CoreWebView2Profile 類別

WinRT/C#

建立一個定義設定檔的選項物件：

• CoreWebView2Environment 班：
  • CoreWebView2Environment.CreateCoreWebView2ControllerOptions 方法
• CoreWebView2ControllerOptions 類別

建立一個 WebView2 控制項，使用以下設定檔：

• CoreWebView2Environment 班：
  • CoreWebView2Environment.CreateCoreWebView2CompositionControllerAsync (parentWindow) 方法
  • CoreWebView2Environment.CreateCoreWebView2CompositionControllerAsync (parentWindow, options) Method
  • CoreWebView2Environment.CreateCoreWebView2ControllerAsync (parentWindow, options) Method
  • CoreWebView2Environment.CreateCoreWebView2ControllerAsync (parentWindow) 方法

存取並操作該檔案：

• CoreWebView2 班：
  • CoreWebView2.Profile 屬性
• CoreWebView2Profile 類別

Win32/C++

建立一個定義設定檔的選項物件：

• ICoreWebView2Environment10 界面：
  • ICoreWebView2Environment10：：CreateCoreWebView2ControllerOptions 方法
• ICoreWebView2ControllerOptions 介面

建立一個 WebView2 控制項，使用以下設定檔：

• ICoreWebView2Environment10 界面：
  • ICoreWebView2Environment10：：CreateCoreWebView2ControllerWithOptions method
  • 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 Enum

  • MostStable
  • LeastStable

• CoreWebView2ReleaseChannels Enum

  • None
  • Stable
  • Beta
  • Dev
  • Canary

WinRT/C#

• CoreWebView2EnvironmentOptions 班：

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

• CoreWebView2ChannelSearchKind Enum

  • MostStable
  • LeastStable

• CoreWebView2ReleaseChannels Enum

  • 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.IsKerneled Property
  • CoreWebView2.Resume 方法
  • CoreWebView2.OpenTaskManagerWindow 方法

WinRT/C#

• CoreWebView2 班：
  • CoreWebView2.TrySuspendAsync 方法
  • CoreWebView2.IsKerneled Property
  • CoreWebView2.Resume 方法
  • CoreWebView2.OpenTaskManagerWindow 方法

Win32/C++

• ICoreWebView2_3 界面：

  • ICoreWebView2_3：：TrySuspend 方法
  • ICoreWebView2_3：：get_IsSuspended 方法
  • ICoreWebView2_3：：履歷方法

• 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) 提供 API 來檢查、檢查、除錯及分析基於 Chromium 的瀏覽器。 Chrome DevTools 協定是 Microsoft Edge DevTools 的基礎。 對於 WebView2 平台未實作的功能，請使用 Chrome DevTools 協定。

另請參閱:

• 在 WebView2 應用程式中使用 Chrome DevTools 協定 (CDP)
• Chrome 開發工具協定

.NET/C#

開：

• CoreWebView2Settings 班：
  • CoreWebView2Settings.AreDevToolsEnabled プロパティ
• CoreWebView2 班：
  • CoreWebView2.OpenDevToolsWindow Method

叫：

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

接球員：

• CoreWebView2 班：
  • CoreWebView2.GetDevToolsProtocolEventReceiver 方法
• CoreWebView2DevToolsProtocolEventReceivedEventArgs 類別
• CoreWebView2DevToolsProtocolEventReceiver 類別

WinRT/C#

開：

• CoreWebView2Settings 班：
  • CoreWebView2Settings.AreDevToolsEnabled プロパティ
• CoreWebView2 班：
  • CoreWebView2.OpenDevToolsWindow Method

叫：

• 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 方法
• ICoreWebView2DevTools ProtocolEventReceiver 介面
• ICoreWebView2DevToolsProtocolEventReceivedEventArgs 介面

另請參閱

• Microsoft Edge WebView2 簡介
• WebView2 API 參考 - 提供其他平台與語言的 API 參考連結，例如 WinRT/C++ (COM) 。