WinUI 2 (UWP) 應用程式中的 WebView2

下列考慮適用於 WinUI 2 中的 WebView2 (UWP) 應用程式。 WebView2 WinUI 2 (UWP) 控制件正在開發中。

自動填入UI

UWP app 的 WebView2 尚未實作自動填入 UI。

另請參閱:

• 在 WebView2 API 概觀中自動填入。

列印為 PDF

列印至 PDF 需要應用程式能夠存取 UWP 中的可寫入位置，例如本機資料夾。 如需 UWP 可存取路徑的完整清單，請參閱 檔案訪問許可權。

另請參閱:

• 在WebView2 API 概觀中列印。

預設列印

UWP app 的 WebView2 預設列印已停用。 不過，您可以呼叫 CapturePreview來擷取和列印目前的檢視區。

另請參閱:

• WebView2 API 概觀中的影像擷取。

SmartScreen

WebView2 會將應用程式中巡覽至 的 URL 傳送至 SmartScreen 服務，以確保您的客戶保持安全。 如果您想要停用此導覽，您可以透過環境變數來執行此動作：

• Environment.SetEnvironmentVariable("WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS", "--disable-features=msSmartScreenProtection");

此環境變數必須在建立之前 CoreWebView2 設定，這會在一開始設定 WebView2.Source屬性 或最初呼叫 WebView2.EnsureCoreWebView2Async方法 時發生。

下載檔

UWP 中 WebView2 目前的下載行為有幾個已知限制。

另存新檔

透過 [另 存 新檔] 儲存盤案正在運作，且已針對UWP app啟用WebView2。 檔案會儲存在用戶選取的資料夾中。

檔案下載到哪個資料夾

如果主機未變更 ResultFilePath 下載檔的 ，則下載的檔案會下載到資料夾中 Downloads 具有應用程式套件名稱的子資料夾。

如果主機變更 ResultFilePath 已下載檔案的 ，則只有在應用程式默認可以存取該檔案路徑時，才會下載該檔案。 如果您想要使用應用程式預設無法存取的檔案位置，您必須設定對應的功能。 請參閱 UWP 檔案中的 應用程式功能宣告 。

下載中樞

已停用從下載中樞開啟檔案和資料夾。 按兩下檔案或資料夾圖示不會開啟個別的檔案/資料夾。

另請參閱:

• WebView2 API 概觀中的下載。

XAML 限制

XAML Island 支援需要額外的工作，未來版本可能會考慮使用。

設定 DefaultBackgroundColor

在 WinUI 2 上 DefaultBackgroundColor ，不會直接公開 屬性。 您可以設定環境變數來設定預設背景色彩，如下所示：

Environment.SetEnvironmentVariable("WEBVIEW2_DEFAULT_BACKGROUND_COLOR", "FF000000");

另請參閱:

• .NET： WebView2.DefaultBackgroundColor 屬性
• Win32： ICoreWebView2Controller2：:D efaultBackgroundColor 属性 (get， put)

設定透明度

在 WinUI 2 上，透明度是藉由將色彩設定為 來 00FFFFFF達成。

CSS 數據指標

在 WinUI 2 (UWP) 上，CSS 數據指標有下列限制。

影像 URL

CSS 資料指標不能是影像 URL，例如 cursor: url(https://contoso.com/cursor.png), pointer;。 請參閱 CSS - 從 URL 載入的數據指標無法運作。

預先定義的 CSS 數據指標

在 WinUI 2 (UWP) 上，不支援某些預先定義的 CSS 數據指標。 您可以使用 CSS 資料指標將資料指標變更為某些預先定義的資料指標，例如 cursor: wait; 或 cursor: crosshair;，但不能變更為其他資料指標，例如 cursor: progress 或 cursor: none。

另請參閱:

• CSS 數據指標 - Values 區段描述上述關鍵字值。

Microsoft Edge 開發人員工具

在 WinUI 2 上，Microsoft Edge DevTools 無法在市集簽署的 WebView2 WinUI 2 (UWP) 應用程式內啟動。 不過，您可以使用遠端偵錯來解決此問題。 請參閱 遠端偵錯 WebView2 WinUI 2 (UWP) 應用程式。

API 限制

下列類別無法在 WinUI 2 中存取：

• CoreWebView2EnvironmentOptions
• CoreWebView2ControllerOptions

另請參閱

• 在 WebView2 API 概觀中自動填入。
• 在WebView2 API 概觀中列印。
• WebView2 API 概觀中的影像擷取。
• WebView2 API 概觀中的下載。
• 遠端偵錯 WebView2 WinUI 2 (UWP) 應用程式

API 參考：

• .NET： WebView2.DefaultBackgroundColor 屬性
• Win32： ICoreWebView2Controller2：：_getDefaultBackgroundColor
• Win32： ICoreWebView2Controller2：：_putDefaultBackgroundColor

Windows 檔：

• SmartScreen
• WebView2.Source 屬性
• WebView2.EnsureCoreWebView2Async 方法
• 應用程式功能宣告

MDN：

• MDN 的數據指標 CSS 屬性中的值。

WebView2Feedback 存放庫：

• CSS - 從 URL 載入的數據指標無法運作