本主題提供 UWP API 到其 Windows 應用程式 SDK 等效項的對應。 在某些情況下，對應不是一對一的；對於命名空間或類別，任一平台可能比另一個平台具有更多或更少的功能。
兩個平台之間的命名空間和類別 (包括 UI 控制項) 的名稱存在差異。 在許多情況下，這就像更改名稱空間名稱一樣簡單，然後您的程式碼就會編譯。 有時，類別或 API 名稱以及命名空間名稱都會發生變更。 其他時候，對應需要更多的工作來完成，而且在極少數情況下需要改變方法來實現。
如何使用資料表。 首先，搜尋您使用的類別成員名稱。 只要映射比簡單的類別名稱或命名空間名稱變更更複雜，就會列出成員。 如果您的成員未列出，請搜尋您正在使用的類別名稱。 只要對應比簡單地更改名稱空間名稱更複雜，就會列出類別 (關於具體指導，請參閱功能區域指南)。 如果您的類別未列出，則對應只是名稱空間變更。 因此，找到類別的命名空間名稱，然後您將找到等效的 Windows 應用程式 SDK 命名空間名稱。 您的類別將位於該名稱空間中。 如果您的命名空間未列出，則其名稱尚未變更。
| UWP | Windows 應用程式 SDK |
|---|---|
| （Windows.ApplicationModel.Activation） LaunchActivatedEventArgs 類別 | （Microsoft.UI.Xaml） LaunchActivatedEventArgs 類別;例如，在 App.OnLaunched。 |
| （Windows.ApplicationModel.Background） BackgroundTaskBuilder 類別 | （Microsoft.Windows.ApplicationModel.Background） BackgroundTaskBuilder 類別。 請參閱有關在 Windows 應用程式中使用背景工作的 。 |
| （Windows.ApplicationModel.Core） CoreApplication.CreateNewView 方法 | （Microsoft.UI.Windowing） AppWindow.Create 方法 |
| （Windows.ApplicationModel.Core） CoreApplicationViewTitleBar class | （Microsoft.UI.Windowing） AppWindowTitleBar 類別 |
| （Windows.ApplicationModel.Core） CoreApplicationViewTitleBar.ExtendViewIntoTitleBar property | （Microsoft.UI.Windowing） AppWindowTitleBar.ExtendsContentIntoTitleBar 屬性。 平台持續為你繪製 「最小化/、最大化/關閉」 按鈕，並回報遮蔽資訊。 |
| （Windows.ApplicationModel.Core） CoreApplicationViewTitleBar.Height property | （Microsoft.UI.Windowing） AppWindowTitleBar.Height 屬性 |
| （Windows.ApplicationModel.Core） CoreApplicationViewTitleBar.SystemOverlayLeftInset property | （Microsoft.UI.Windowing） AppWindowTitleBar.LeftInset 屬性 |
| （Windows.ApplicationModel.Core） CoreApplicationViewTitleBar.SystemOverlayRightInset 屬性 | （Microsoft.UI.Windowing） AppWindowTitleBar.RightInset 屬性 |
| Windows.ApplicationModel.Resources.Core 命名空間 | Microsoft.Windows.ApplicationModel.Resources. 請參閱 MRT 到 MRT 核心遷移。 |
| （Windows.ApplicationModel.Resources.Core） ResourceContext.GetForCurrentView method | （Microsoft.Windows.ApplicationModel.Resources） ResourceManager.CreateResourceContext 方法。 請參閱 ResourceContext.GetForCurrentView 和 ResourceContext.GetForViewIndependentUse。 |
| （Windows.ApplicationModel.Resources.Core） ResourceContext.GetForViewIndependentUse method | （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 類別 | （Microsoft.Windows.Media.Capture） CameraCaptureUI 類別 |
| （Windows.Security.Authentication.Web） WebAuthenticationBroker 類別 | （Microsoft.Security.Authentication.OAuth） OAuth2Manager 類別（支援於 Windows App SDK 1.7 及更新版本）。 如需使用 OAuth2Manager 和相關 API 來執行 OAuth 2.0 驗證的詳細資訊，請參閱 在 Windows 應用程式中實作 OAuth 功能。 完整範例應用請見 GitHub 。 |
| （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 method | 沒有直接 1：1 對應至 Windows 應用程式 SDK API。 使用 XAML 時，你可以讓 Window.AppWindow 取得與 XAML 視窗相關的 AppWindow，但如果應用程式想從其他無法存取的地方存取該視窗或 AppWindow，就必須先快取該視窗或 AppWindow。 我們建議快取並公開 App 物件上的視窗。 |
| （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 method |
| （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） AccessibilitySettings.HighContrastChanged 事件 | （Microsoft.UI.System） ThemeSettings.Changed 事件 |
| （Windows.UI.ViewManagement） ApplicationView 類別 | （Microsoft.UI.Windowing） AppWindow 類別 |
| （Windows.UI.ViewManagement） ApplicationView.Title 屬性 | （Microsoft.UI.Windowing） AppWindow.Title 屬性 |
| （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.CompactOverlay |
| （Windows.UI.ViewManagement） ApplicationView.TryResizeView 方法 | （Microsoft.UI.Windowing） AppWindow.Resize 方法 |
| （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.Resize 方法 |
| （Windows.UI.WindowManagement） AppWindow.Title 屬性 | （Microsoft.UI.Windowing） AppWindow.Title 屬性 |
| （Windows.UI.WindowManagement） AppWindow.TryCreateAsync 方法 | （Microsoft.UI.Windowing） AppWindow.Create 方法 |
| （Windows.UI.WindowManagement） AppWindow.TryShowAsync 方法 | （Microsoft.UI.Windowing） AppWindow.Show 方法 |
| （Windows.UI.WindowManagement） AppWindowChangedEventArgs.DidSizeChange method | （Microsoft.UI.Windowing） AppWindowChangedEventArgs.DidSizeChange method |
| （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 method | （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 property | （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.OnFileActivated 方法（在 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） 彈出 類別 | （Microsoft.UI.Xaml.Controls.Primitives） 視窗彈出 是受到支持的，但你必須設定它的 XamlRoot 屬性。 請參閱 ContentDialog 和彈出視窗。 |
| （Windows.UI.Xaml.Media） AcrylicBrush.BackgroundSource 屬性 | 在 Windows 應用程式 SDK 中，（Microsoft.UI.Xaml.Media）的 AcrylicBrush 總是從應用程式內容取樣。 請參見 AcrylicBrush.BackgroundSource 屬性。 |
C++/WinRT. co_await winrt.resume_foreground(this->Dispatcher()); |
參見 遷移 winrt.resume_foreground |
第三方函式庫
本部分介紹了 UWP 支援的各種庫，並且在使用 WinUI 3 時需要更改。
| UWP | Windows 應用程式 SDK |
|---|---|
| OneDrive SDK | Microsoft Graph SDK |
