將 UWP API 和函式庫對應到 Windows 應用程式 SDK
本主題提供 UWP API 到其 Windows 應用程式 SDK 等效項的對應。 在某些情況下，對應不是一對一的；而是一對一的。對於命名空間或類別，任一平台可能比另一個平台具有更多或更少的功能。
兩個平台之間的命名空間和類別 (包括 UI 控制項) 的名稱存在差異。 在許多情況下，這就像更改名稱空間名稱一樣簡單，然後您的程式碼就會編譯。 有時，類別或 API 名稱以及命名空間名稱都會發生變更。 其他時候，對應射需要更多的工作，並且在極少數情況下需要改變方法。
如何使用資料表。 首先，搜尋您使用的類別成員名稱。 只要映射比簡單的類別名稱或命名空間名稱變更更複雜，就會列出成員。 如果您的成員未列出，請搜尋您正在使用的類別名稱。 只要對應比簡單地更改名稱空間名稱更複雜，就會列出類別 (關於具體指導，請參閱功能區域指南)。 如果您的類別未列出，則對應只是名稱空間變更。 因此，找到類別的命名空間名稱，然後您將找到等效的 Windows 應用程式 SDK 命名空間名稱。 您的類別將位於該名稱空間中。 如果您的命名空間未列出，則其名稱尚未變更。
| UWP | Windows 應用程式 SDK |
|---|---|
| (Windows.ApplicationModel.Activation) LaunchActivatedEventArgs 類別 | (Microsoft.UI.Xaml) LaunchActivatedEventArgs 類別；例如 App.OnLaunched。 |
| (Windows.ApplicationModel.Core) CoreApplication.CreateNewView 方法 | (Microsoft.UI.Windowing) AppWindow.Create 方法 |
| (Windows.ApplicationModel.Core) CoreApplicationViewTitleBar 類別 | (Microsoft.UI.Windowing) AppWindowTitleBar 類別 |
| (Windows.ApplicationModel.Core) CoreApplicationViewTitleBar.ExtendViewIntoTitleBar 屬性 | (Microsoft.UI.Windowing) AppWindowTitleBar.ExtendsContentIntoTitleBar 属性。 平台會繼續為您繪製 Minimize/Maximize/Close 按鈕，並報告遮擋資訊。 |
| (Windows.ApplicationModel.Core) CoreApplicationViewTitleBar.Height 屬性 | (Microsoft.UI.Windowing) AppWindowTitleBar.Height 屬性 |
| (Windows.ApplicationModel.Core) CoreApplicationViewTitleBar.SystemOverlayLeftInset 属性 | (Microsoft.UI.Windowing) AppWindowTitleBar.Height 屬性 |
| (Windows.ApplicationModel.Core) CoreApplicationViewTitleBar.SystemOverlayLeftInset 属性 | (Microsoft.UI.Windowing) AppWindowTitleBar.Height 屬性 |
| Windows.ApplicationModel.Resources.Core 命名空間 | Microsoft.Windows.ApplicationModel.Resources。 請參閱 MRT 至 MRT 核心移轉。 |
| (Windows.ApplicationModel.Resources.Core) ResourceContext.GetForCurrentView 方法 | (Microsoft.Windows.ApplicationModel.Resources) ResourceManager.CreateResourceContext 方法。 請參閱 ResourceContext.GetForCurrentView 和 ResourceContext.GetForViewIndependentUse。 |
| (Windows.ApplicationModel.Resources.Core) ResourceContext.GetForCurrentView 方法 | (Microsoft.Windows.ApplicationModel.Resources) ResourceManager.CreateResourceContext 方法。 請參閱 ResourceContext.GetForCurrentView 和 ResourceContext.GetForViewIndependentUse。 |
| (Windows.ApplicationModel.Resources.Core) ResourceManager.Current 屬性 | 建立新的 (Microsoft.Windows.ApplicationModel.Resources) ResourceManager 物件。 請參閱 ResourceManager 類別。 |
| (Windows.ApplicationModel.Resources.Core) ResourceQualifierObservableMap.MapChanged 事件 | 自行偵測環境變更。 請參閱資源限定符值變更。 |
| (Windows.Graphics.Printing) PrintManager 類別 | Windows 應用程式 SDK 1.0 不支援。 |
| (Windows.Media.Capture) CameraCaptureUI 類別 | Windows 應用程式 SDK 1.0 不支援。 |
| (Windows.Security.Authentication.Web) WebAuthenticationBroker 類別 | Windows 應用程式 SDK 1.0 不支援。 |
| (Windows.Storage.Pickers) FileOpenPicker、FileSavePicker 和 FolderPicker 類別 | 有支援，但您必須使用 IInitializeWithWindow 介面。 請參閱 MessageDialog 和 Pickers。 |
| (Windows.System.Display) DisplayRequest 類別 | Windows 應用程式 SDK 1.0 不支援。 |
| Windows.UI.Composition 命名空間 | Microsoft.UI.Composition 命名空間 |
| (Windows.UI.Core) CoreDispatcher 類別 | (Microsoft.UI.Dispatching) DispatcherQueue 類別。 請參閱 將 CoreDispatcher 變更為 DispatcherQueue。 |
| (Windows.UI.Core) CoreDispatcher.RunAsync 方法 | (Microsoft.UI.Dispatching) DispatcherQueue.TryEnqueue 方法。 請參閱 將 RunAsync 變更為 TryEnqueue。 |
| (Windows.UI.Core) CoreWindow 類別 | (Microsoft.UI.Windowing) AppWindow 類別。 請參閱視窗化功能移轉。 |
(Windows.UI.Core) CoreWindow.Bounds 屬性 (在 C# 中通常顯示為 CoreWindow.GetForCurrentThread.Bounds) |
(Microsoft.UI.Windowing) AppWindow.Size 屬性 |
| (Windows.UI.Core) CoreWindow.GetForCurrentThread 方法 | 沒有直接 1：1 對應至 Windows 應用程式 SDK API。 使用 XAML 時，您可以取得 Window.AppWindow 來取得與 XAML 視窗相關聯的 AppWindow，但如果應用程式想要從沒有存取權的某個位置存取它，則應用程式必須快取 Window 或 AppWindow。 建議您快取並公開 App 物件上的 Window。 |
| (Windows.UI.Core) CoreWindow.Activate 方法 | (Microsoft.UI.Windowing) AppWindow.Show 方法 |
| (Windows.UI.Core) CoreWindow.Dispatcher 屬性 | (Microsoft.UI.Xaml) Window.DispatcherQueue 屬性。 請參閱 將 CoreWindow.Dispatcher 變更為 Window.DispatcherQueue。 |
| (Windows.UI.Core) CoreWindow.SizeChanged 事件 | (Microsoft.UI.Windowing) AppWindowChangedEventArgs.DidSizeChange 方法 |
| (Windows.UI.Core) SystemNavigationManager 類別 (全域返回按鈕) | 不支援。 在您自己的 UI 中實作返回按鈕。 請參閱 UWP PhotoLab 範例應用程式的 Windows 應用程式 SDK 移轉 (C#)。 |
| (Windows.UI.Core) WindowSizeChangedEventArgs 類別 | (Microsoft.UI.Xaml) WindowSizeChangedEventArgs 類別；例如，在 (Microsoft.UI.Xaml)Window.SizeChanged 的處理程式中。 |
| (Windows.UI.Popups) MessageDialog 類別 | 有支援，但您必須使用 IInitializeWithWindow 介面。 請參閱 MessageDialog 和 Pickers。 |
| (Windows.UI.Text.Core) CoreTextServicesManager 類別 | 僅在 Windows 11 上支援。 |
| (Windows.UI.ViewManagement) ApplicationView 類別 | (Microsoft.UI.Windowing) AppWindow 類別。 |
| (Windows.UI.ViewManagement) ApplicationView.Title 屬性 | (Microsoft.UI.Windowing) AppWindow.Size 屬性 |
| (Windows.UI.ViewManagement) ApplicationView.TryConsolidateAsync 方法 | (Microsoft.UI.Windowing) AppWindow.Destroy 方法 |
| (Windows.UI.ViewManagement) ApplicationView.TryEnterFullScreenMode 方法 | (Microsoft.UI.Windowing) AppWindow.SetPresenter 方法與 AppWindowPresenterKind.FullScreen |
| (Windows.UI.ViewManagement) ApplicationView.TryEnterViewModeAsync 方法與 ApplicationViewMode.CompactOverlay | (Microsoft.UI.Windowing) AppWindow.SetPresenter 方法與 AppWindowPresenterKind.FullScreen |
| (Windows.UI.ViewManagement) ApplicationView.TryResizeView 方法 | (Microsoft.UI.Windowing) AppWindow.Create 方法 |
| (Windows.UI.ViewManagement) ApplicationViewMode.CompactOverlay 欄位 | (Microsoft.UI.Windowing) AppWindowPresenterKind.CompactOverlay 欄位 |
| (Windows.UI.ViewManagement) ApplicationViewTitleBar 類別 | (Microsoft.UI.Windowing) AppWindowTitleBar 類別 |
| (Windows.UI.ViewManagement) ApplicationViewWindowingMode.FullScreen 欄位 | (Microsoft.UI.Windowing) AppWindowPresenterKind.FullScreen 欄位 |
| (Windows.UI.WindowManagement) AppWindow 類別 | (Microsoft.UI.Windowing) AppWindow 類別。 |
| (Windows.UI.WindowManagement) AppWindow.Changed 事件 | (Microsoft.UI.Windowing) Microsoft.UI.Windowing.AppWindow.Changed 事件 |
| (Windows.UI.WindowManagement) AppWindow.CloseAsync 方法 | (Microsoft.UI.Windowing) AppWindow.Destroy 方法 |
| (Windows.UI.WindowManagement) AppWindow.GetPlacement 方法 | (Microsoft.UI.Windowing) AppWindow.Position 屬性 |
| (Windows.UI.WindowManagement) Appwindow.RequestMoveXxx 方法 | (Microsoft.UI.Windowing) AppWindow.Move 方法 |
| (Windows.UI.WindowManagement) AppWindow.RequestSize 方法 | (Microsoft.UI.Windowing) AppWindow.Create 方法 |
| (Windows.UI.WindowManagement) AppWindow.Title 屬性 | (Microsoft.UI.Windowing) AppWindow.Size 屬性 |
| (Windows.UI.WindowManagement) AppWindow.CloseAsync 方法 | (Microsoft.UI.Windowing) AppWindow.Create 方法 |
| (Windows.UI.WindowManagement) AppWindow.CloseAsync 方法 | (Microsoft.UI.Windowing) AppWindow.Show 方法 |
| (Windows.UI.WindowManagement) AppWindowChangedEventArgs.DidSizeChange 方法 | (Microsoft.UI.Windowing) AppWindowChangedEventArgs.DidSizeChange 方法 |
| (Windows.UI.WindowManagement) AppWindowPlacement.Size 屬性 | (Microsoft.UI.Windowing) AppWindow.Size 屬性 |
| (Windows.UI.WindowManagement) AppWindowPresentationKind.CompactOverlay 欄位 | (Microsoft.UI.Windowing) AppWindowPresenterKind.CompactOverlay 欄位 |
| (Windows.UI.WindowManagement) AppWindowPresentationKind.FullScreen 欄位 | (Microsoft.UI.Windowing) AppWindowPresenterKind.FullScreen 欄位 |
| (Windows.UI.WindowManagement) AppWindowPresenter.RequestPresentation 方法 | (Microsoft.UI.Windowing) AppWindow.SetPresenter 方法 |
| (Windows.UI.WindowManagement) AppWindowTitleBar 類別 | (Microsoft.UI.Windowing) AppWindowTitleBar 類別 |
| (Windows.UI.WindowManagement) AppWindowTitleBar.GetPreferredVisibility | 沒有直接 1:1 對應到 Windows 應用程式 SDK API |
| (Windows.UI.WindowManagement) AppWindowTitleBar.GetTitleBarOcclusions | (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset 和 RightInset，搭配 Height，提供相同資訊。 |
| (Windows.UI.WindowManagement) AppWindowTitleBar.SetPreferredVisibility | 沒有直接 1:1 對應到 Windows 應用程式 SDK API |
| (Windows.UI.WindowManagement) AppWindowTitleBarOcclusion 屬性 | (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset 和 RightInset，搭配 Height，提供相同資訊。 |
| (Windows.UI.WindowManagement) AppWindowTitleBarVisibility | 沒有直接 1:1 對應到 Windows 應用程式 SDK API |
| Windows.UI.Xaml 命名空間 | Microsoft.UI.Xaml 命名空間 |
(Windows.UI.Xaml) Application.OnActivated 方法 (在 C# 中通常出現為 App.OnActivated) |
請參閱 OnActivated、OnBackgroundActivated 和其他啟用處理方法。 |
(Windows.UI.Xaml) Application.OnBackgroundActivated 方法 (在 C# 中通常出現為 App.OnBackgroundActivated) |
請參閱 OnActivated、OnBackgroundActivated 和其他啟用處理方法。 |
(Windows.UI.Xaml) Application.OnCachedFileUpdaterActivated 方法 (在 C# 中通常出現為 App.OnCachedFileUpdaterActivated) |
請參閱 OnActivated、OnBackgroundActivated 和其他啟用處理方法。 |
(Windows.UI.Xaml) Application.OnActivated 方法 (在 C# 中通常出現為 App.OnFileActivated) |
請參閱檔案類型關聯和 OnActivated、OnBackgroundActivated 和其他啟用處理方法。 |
(Windows.UI.Xaml) Application.OnFileOpenPickerActivated 方法 (在 C# 中通常出現為 App.OnFileOpenPickerActivated) |
請參閱 OnActivated、OnBackgroundActivated 和其他啟用處理方法。 |
(Windows.UI.Xaml) Application.OnFileSavePickerActivated 方法 (在 C# 中通常出現為 App.OnFileSavePickerActivated) |
請參閱 OnActivated、OnBackgroundActivated 和其他啟用處理方法。 |
(Windows.UI.Xaml) Application.OnSearchActivated 方法 (在 C# 中通常出現為 App.OnSearchActivated) |
請參閱 OnActivated、OnBackgroundActivated 和其他啟用處理方法。 |
(Windows.UI.Xaml) Application.OnShareTargetActivated 方法 (在 C# 中通常出現為 App.OnShareTargetActivated) |
請參閱 OnActivated、OnBackgroundActivated 和其他啟用處理方法。 |
| （Windows.UI.Xaml） Window.Current 屬性 | 已取代，並傳回 null。 如需替代方案，請參閱將 Window.Current 變更為 App.Window。 |
(Windows.UI.Xaml) Window.Dispatcher 屬性 (通常用 C# 寫為 Window.Current.Dispatcher) |
(Microsoft.UI.Xaml) Window.DispatcherQueue 屬性 |
| (Windows.UI.Xaml.Controls) ContentDialog 類別 | (Microsoft.UI.Xaml.Controls) ContentDialog 受到支援，但您必須設定其 XamlRoot 屬性。 請參閱 ContentDialog 和快顯。 |
| (Windows.UI.Xaml.Controls) InkCanvas 類別 | Windows 應用程式 SDK 1.0 不支援。 |
| (Windows.UI.Xaml.Controls) MediaElement 類別 | Windows 應用程式 SDK 1.0 不支援。 |
| (Windows.UI.Xaml.Controls.Maps) MapControl 類別 | （Microsoft.UI.Xaml.Controls） MapControl 類別 |
| (Windows.UI.Xaml.Controls.Primitives) Popup class | (Microsoft.UI.Xaml.Controls.Primitives) 支援彈出視窗 ，但您必須設定其 XamlRoot 屬性。 請參閱 ContentDialog 和快顯。 |
| (Windows.UI.Xaml.Media) AcrylicBrush.BackgroundSource 屬性 | 在 Windows 應用程式 SDK 中，(Microsoft.UI.Xaml.Media) AcrylicBrush 一律會從應用程式內容範例。 查閱 AcrylicBrush.BackgroundSource property。 |
C++/WinRT。 co_await winrt.resume_foreground(this->Dispatcher()); |
請參閱 移轉winrt.resume_foreground |
第三方程式庫
本部分介紹了 UWP 支援的各種庫，並且在使用 WinUI 3 時需要更改。
| UWP | Windows 應用程式 SDK |
|---|---|
| OneDrive SDK | Microsoft Graph SDK |
