本主題提供 UWP API 與其 Windows 應用程式 SDK 對應版本的對應映射。 在某些情況下，對應不是一對一的；對於命名空間或類別，任一平台可能比另一個平台具有更多或更少的功能。
兩個平台之間的命名空間和類別 (包括 UI 控制項) 的名稱存在差異。 在許多情況下，這就像更改名稱空間名稱一樣簡單，然後您的程式碼就會編譯。 有時，類別或 API 名稱以及命名空間名稱都會發生變更。 其他時候，對應需要更多的工作來完成，而且在極少數情況下需要改變方法來實現。
如何使用資料表。 首先，搜尋您使用的類別成員名稱。 只要映射比簡單的類別名稱或命名空間名稱變更更複雜，就會列出成員。 如果您的成員未列出，請搜尋您正在使用的類別名稱。 當映射比僅僅更改命名空間名稱更複雜時，類會被列出（如需具體指引，請參見 Feature 區域指南）。 如果您的類別未列出，則對應只是名稱空間變更。 所以，找到你類別的命名空間名稱，然後你會找到對應的 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 Core 遷移。 |
| （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 class。 |
| （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 應用程式 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 類別。 請參見 Windowing 功能遷移 。 |
（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 Window 關聯的 AppWindow，但如果應用程式想從無法存取的位置進行存取，則必須快取 Window 或 AppWindow。 我們建議快取並公開 App 物件上的視窗。 |
| （Windows.UI.Core） CoreWindow.Activate 方法 | （Microsoft.UI.Windowing） AppWindow.Show 方法 |
| （Windows.UI.Core） CoreWindow.Dispatcher 屬性 | （Microsoft.UI.Xaml） Window.DispatcherQueue 屬性。 請參見 Change 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、OnBackgroundActivate 及其他啟動處理方法。 |
（Windows.UI.Xaml） Application.OnBackgroundActivated 方法（在 C# 中常見為 App.OnBackgroundActivated） |
請參見 OnActivated、OnBackgroundActivate 及其他啟動處理方法。 |
（Windows.UI.Xaml） Application.OnCachedFileUpdaterActivated 方法（在 C# 中常見為 App.OnCachedFileUpdaterActivated） |
請參見 OnActivated、OnBackgroundActivate 及其他啟動處理方法。 |
（Windows.UI.Xaml） Application.OnFileActivated 方法（在 C# 中常見為 App.OnFileActivated） |
請參見 檔案類型關聯 以及 OnActivated、OnBackgroundActivated 及其他啟用處理方法。 |
（Windows.UI.Xaml） Application.OnFileOpenPickerActivated 方法（在 C# 中常見為 App.OnFileOpenPickerActivated） |
請參見 OnActivated、OnBackgroundActivate 及其他啟動處理方法。 |
（Windows.UI.Xaml） Application.OnFileSavePickerActivated 方法（在 C# 中常見為 App.OnFileSavePickerActivated） |
請參見 OnActivated、OnBackgroundActivate 及其他啟動處理方法。 |
（Windows.UI.Xaml） Application.OnSearchActivated 方法（在 C# 中常見為 App.OnSearchActivated） |
請參見 OnActivated、OnBackgroundActivate 及其他啟動處理方法。 |
（Windows.UI.Xaml） Application.OnShareTargetActivated 方法（在 C# 中常見為 App.OnShareTargetActivated） |
請參見 OnActivated、OnBackgroundActivate 及其他啟動處理方法。 |
| （Windows.UI.Xaml） Window.Current 屬性 | 已棄用，並傳回 null。 替代方案請參見 Change Window.Current to 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，以及 Popup。 |
| （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，以及 Popup。 |
| （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()); |
參見 Migrate winrt.resume_foreground |
第三方函式庫
本部分介紹了 UWP 支援的各種庫，並且在使用 WinUI 3 時需要更改。
| UWP | Windows 應用程式 SDK |
|---|---|
| OneDrive SDK | Microsoft Graph SDK |
