Share via

將 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 方法 (Microsoft.UI.Windowing) AppWindow.Create 方法
(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 類別 Windows 應用程式 SDK 1.0 不支援。
(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