Zuordnen von UWP-APIs und -Bibliotheken zum Windows App SDK
Dieses Thema enthält eine Zuordnung von UWP-APIs zu ihren Windows App SDK Entsprechungen. In einigen Fällen ist die Zuordnung nicht eins zu 1; Jede Plattform verfügt möglicherweise über mehr oder weniger Funktionen als die andere für einen Namespace oder eine Klasse.
Zwischen den beiden Plattformen gibt es Unterschiede bei den Namen von Namespaces und Klassen (einschließlich UI-Steuerelemente). In vielen Fällen ist es einfach: Sie ändern z. B. einen Namespacenamen, und der Code wird kompiliert Manchmal wird neben dem Namespacenamen auch der Name einer Klasse oder API geändert In anderen Fällen ist die Zuordnung etwas schwieriger. In seltenen Fällen muss der Ansatz geändert werden.
Verwenden der Tabelle Suchen Sie zunächst nach dem Namen des von Ihnen verwendeten Klassenmembers. Member werden immer dann aufgeführt, wenn die Zuordnung komplizierter ist als eine einfache Klassennamen- oder Namespacenamenänderung. Wenn Ihr Member nicht aufgeführt ist, suchen Sie nach dem Namen der verwendeten Klasse. Klassen werden immer dann aufgeführt, wenn die Zuordnung komplizierter ist als das einfache Ändern des Namespacenamens (spezifische Anleitungen finden Sie in den Leitfäden des Featurebereichs). Wenn Ihre Klasse nicht aufgeführt ist, ist die Zuordnung nur eine Namespaceänderung. Suchen Sie also den Namespacenamen Ihrer Klasse, und dann finden Sie den entsprechenden Windows App SDK Namespacenamen. Ihre Klasse ist in diesem Namespace enthalten. Wenn Ihr Namespace nicht aufgeführt ist, hat sich sein Name nicht geändert.
| UWP | Windows-App-SDK |
|---|---|
| (Windows.ApplicationModel.Activation) LaunchActivatedEventArgs-Klasse | (Microsoft.UI.Xaml) LaunchActivatedEventArgs-Klasse ; beispielsweise in App.OnLaunched. |
| (Windows.ApplicationModel.Core) CoreApplication.CreateNewView-Methode | (Microsoft.UI.Windowing) AppWindow.Create-Methode |
| (Windows.ApplicationModel.Core) CoreApplicationViewTitleBar-Klasse | (Microsoft.UI.Windowing) AppWindowTitleBar-Klasse |
| (Windows.ApplicationModel.Core) CoreApplicationViewTitleBar.ExtendViewIntoTitleBar-Eigenschaft | (Microsoft.UI.Windowing) AppWindowTitleBar.ExtendsContentIntoTitleBar-Eigenschaft . Die Plattform zeichnet weiterhin die Schaltflächen Minimieren/Maximieren/Schließen für Sie und meldet die Informationen zur Verdeckung. |
| (Windows.ApplicationModel.Core) CoreApplicationViewTitleBar.Height-Eigenschaft | (Microsoft.UI.Windowing) AppWindowTitleBar.Height-Eigenschaft |
| (Windows.ApplicationModel.Core) CoreApplicationViewTitleBar.SystemOverlayLeftInset-Eigenschaft | (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset-Eigenschaft |
| (Windows.ApplicationModel.Core) CoreApplicationViewTitleBar.SystemOverlayRightInset-Eigenschaft | (Microsoft.UI.Windowing) AppWindowTitleBar.RightInset-Eigenschaft |
| Windows.ApplicationModel.Resources.Core-Namespace | Microsoft.Windows.ApplicationModel.Resources. Siehe Migration von MRT zu MRT Core. |
| (Windows.ApplicationModel.Resources.Core) ResourceContext.GetForCurrentView-Methode | (Microsoft.Windows.ApplicationModel.Resources) ResourceManager.CreateResourceContext-Methode . Siehe ResourceContext.GetForCurrentView und ResourceContext.GetForViewIndependentUse. |
| (Windows.ApplicationModel.Resources.Core) ResourceContext.GetForViewIndependentUse-Methode | (Microsoft.Windows.ApplicationModel.Resources) ResourceManager.CreateResourceContext-Methode . Siehe ResourceContext.GetForCurrentView und ResourceContext.GetForViewIndependentUse. |
| (Windows.ApplicationModel.Resources.Core) ResourceManager.Current-Eigenschaft | Erstellen Sie ein neues ResourceManager-Objekt (Microsoft.Windows.ApplicationModel.Resources). Weitere Informationen finden Sie unter ResourceManager-Klasse. |
| (Windows.ApplicationModel.Resources.Core) ResourceQualifierObservableMap.MapChanged-Ereignis | Erkennen Sie Umgebungsänderungen für sich selbst. Weitere Informationen finden Sie unter Änderung des Ressourcenqualifizierers. |
| (Windows.Graphics.Printing) PrintManager-Klasse | In Windows App SDK 1.0 nicht unterstützt. |
| (Windows.Media.Capture) CameraCaptureUI-Klasse | In Windows App SDK 1.0 nicht unterstützt. |
| (Windows.Security.Authentication.Web) WebAuthenticationBroker-Klasse | In Windows App SDK 1.0 nicht unterstützt. |
| (Windows.Storage.Pickers) FileOpenPicker-, FileSavePicker- und FolderPicker-Klassen | Unterstützt, aber Sie müssen die IInitializeWithWindow-Schnittstelle verwenden. Weitere Informationen finden Sie unter MessageDialog und Auswahl. |
| (Windows.System.Display) DisplayRequest-Klasse | In Windows App SDK 1.0 nicht unterstützt. |
| Windows.UI.Composition-Namespace | Microsoft.UI.Composition-Namespace |
| (Windows.UI.Core) CoreDispatcher-Klasse | (Microsoft.UI.Dispatching) DispatcherQueue-Klasse . Weitere Informationen finden Sie unter Ändern von CoreDispatcher in DispatcherQueue. |
| (Windows.UI.Core) CoreDispatcher.RunAsync-Methode | (Microsoft.UI.Dispatching) DispatcherQueue.TryEnqueue-Methode . Weitere Informationen finden Sie unter Ändern von RunAsync in TryEnqueue. |
| (Windows.UI.Core) CoreWindow-Klasse | (Microsoft.UI.Windowing) AppWindow-Klasse . Weitere Informationen finden Sie unter Migration von Fensterfunktionen. |
(Windows.UI.Core) CoreWindow.Bounds-Eigenschaft (wird häufig in C# als CoreWindow.GetForCurrentThread.Boundsangezeigt) |
(Microsoft.UI.Windowing) AppWindow.Size-Eigenschaft |
| (Windows.UI.Core) CoreWindow.GetForCurrentThread-Methode | (Microsoft.UI.Windowing) AppWindow.Create-Methode |
| (Windows.UI.Core) CoreWindow.Activate-Methode | (Microsoft.UI.Windowing) AppWindow.Show-Methode |
| (Windows.UI.Core) CoreWindow.Dispatcher-Eigenschaft | (Microsoft.UI.Xaml) Window.DispatcherQueue-Eigenschaft . Weitere Informationen finden Sie unter Ändern von CoreWindow.Dispatcher in Window.DispatcherQueue. |
| (Windows.UI.Core) CoreWindow.SizeChanged-Ereignis | (Microsoft.UI.Windowing) AppWindowChangedEventArgs.DidSizeChange-Methode |
| (Windows.UI.Core) SystemNavigationManager-Klasse (globale Schaltfläche "Zurück") | Wird nicht unterstützt. Implementieren Sie eine Zurück-Schaltfläche auf Ihrer eigenen Benutzeroberfläche. Weitere Informationen finden Sie unter A Windows App SDK Migration der UWP PhotoLab-Beispiel-App (C#). |
| (Windows.UI.Core) WindowSizeChangedEventArgs-Klasse | (Microsoft.UI.Xaml) WindowSizeChangedEventArgs-Klasse ; beispielsweise in einem Handler für (Microsoft.UI.Xaml) Window.SizeChanged. |
| (Windows.UI.Popups) MessageDialog-Klasse | Unterstützt, aber Sie müssen die IInitializeWithWindow-Schnittstelle verwenden. Weitere Informationen finden Sie unter MessageDialog und Auswahl. |
| (Windows.UI.Text.Core) CoreTextServicesManager-Klasse | Wird nur auf Windows 11 unterstützt. |
| (Windows.UI.ViewManagement) ApplicationView-Klasse | (Microsoft.UI.Windowing) AppWindow-Klasse |
| (Windows.UI.ViewManagement) ApplicationView.Title-Eigenschaft | (Microsoft.UI.Windowing) AppWindow.Title-Eigenschaft |
| (Windows.UI.ViewManagement) ApplicationView.TryConsolidateAsync-Methode | (Microsoft.UI.Windowing) AppWindow.Destroy-Methode |
| (Windows.UI.ViewManagement) ApplicationView.TryEnterFullScreenMode-Methode | (Microsoft.UI.Windowing) AppWindow.SetPresenter-Methode mit AppWindowPresenterKind.FullScreen |
| (Windows.UI.ViewManagement) ApplicationView.TryEnterViewModeAsync-Methode mit ApplicationViewMode.CompactOverlay | (Microsoft.UI.Windowing) AppWindow.SetPresenter-Methode mit AppWindowPresenterKind.CompactOverlay |
| (Windows.UI.ViewManagement) ApplicationView.TryResizeView-Methode | (Microsoft.UI.Windowing) AppWindow.Resize-Methode |
| (Windows.UI.ViewManagement) ApplicationViewMode.CompactOverlay-Feld | (Microsoft.UI.Windowing) AppWindowPresenterKind.CompactOverlay-Feld |
| (Windows.UI.ViewManagement) ApplicationViewTitleBar-Klasse | (Microsoft.UI.Windowing) AppWindowTitleBar-Klasse |
| (Windows.UI.ViewManagement) ApplicationViewWindowingMode.FullScreen-Feld | (Microsoft.UI.Windowing) AppWindowPresenterKind.FullScreen-Feld |
| (Windows.UI.WindowManagement) AppWindow-Klasse | (Microsoft.UI.Windowing) AppWindow-Klasse |
| (Windows.UI.WindowManagement) AppWindow.Changed-Ereignis | (Microsoft.UI.Windowing) Microsoft.UI.Windowing.AppWindow.Changed-Ereignis |
| (Windows.UI.WindowManagement) AppWindow.CloseAsync-Methode | (Microsoft.UI.Windowing) AppWindow.Destroy-Methode |
| (Windows.UI.WindowManagement) AppWindow.GetPlacement-Methode | (Microsoft.UI.Windowing) AppWindow.Position-Eigenschaft |
| (Windows.UI.WindowManagement) Appwindow.RequestMoveXxx-Methoden | (Microsoft.UI.Windowing) AppWindow.Move-Methode |
| (Windows.UI.WindowManagement) AppWindow.RequestSize-Methode | (Microsoft.UI.Windowing) AppWindow.Resize-Methode |
| (Windows.UI.WindowManagement) AppWindow.Title-Eigenschaft | (Microsoft.UI.Windowing) AppWindow.Title-Eigenschaft |
| (Windows.UI.WindowManagement) AppWindow.TryCreateAsync-Methode | (Microsoft.UI.Windowing) AppWindow.Create-Methode |
| (Windows.UI.WindowManagement) AppWindow.TryShowAsync-Methode | (Microsoft.UI.Windowing) AppWindow.Show-Methode |
| (Windows.UI.WindowManagement) AppWindowChangedEventArgs.DidSizeChange-Methode | (Microsoft.UI.Windowing) AppWindowChangedEventArgs.DidSizeChange-Methode |
| (Windows.UI.WindowManagement) AppWindowPlacement.Size-Eigenschaft | (Microsoft.UI.Windowing) AppWindow.Size-Eigenschaft |
| (Windows.UI.WindowManagement) AppWindowPresentationKind.CompactOverlay-Feld | (Microsoft.UI.Windowing) AppWindowPresenterKind.CompactOverlay-Feld |
| (Windows.UI.WindowManagement) AppWindowPresentationKind.FullScreen-Feld | (Microsoft.UI.Windowing) AppWindowPresenterKind.FullScreen-Feld |
| (Windows.UI.WindowManagement) AppWindowPresenter.RequestPresentation-Methode | (Microsoft.UI.Windowing) AppWindow.SetPresenter-Methode |
| (Windows.UI.WindowManagement) AppWindowTitleBar-Klasse | (Microsoft.UI.Windowing) AppWindowTitleBar-Klasse |
| (Windows.UI.WindowManagement) AppWindowTitleBar.GetPreferredVisibility | Keine direkte 1:1-Zuordnung zu einer Windows App SDK-API |
| (Windows.UI.WindowManagement) AppWindowTitleBar.GetTitleBarOcclusions | (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset und RightInset, gekoppelt mit Height, stellen dieselben Informationen bereit. |
| (Windows.UI.WindowManagement) AppWindowTitleBar.SetPreferredVisibility | Keine direkte 1:1-Zuordnung zu einer Windows App SDK-API |
| (Windows.UI.WindowManagement) AppWindowTitleBarOcclusion-Eigenschaft | (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset und RightInset, gekoppelt mit Height, stellen dieselben Informationen bereit. |
| (Windows.UI.WindowManagement) AppWindowTitleBarVisibility | Keine direkte 1:1-Zuordnung zu einer Windows App SDK-API |
| Windows.UI.Xaml-Namespace | Microsoft.UI.Xaml-Namespace |
(Windows.UI.Xaml) Application.OnActivated-Methode (wird häufig in C# als App.OnActivatedangezeigt) |
Weitere Informationen finden Sie unter OnActivated, OnBackgroundActivated und andere Aktivierungsbehandlungsmethoden. |
(Windows.UI.Xaml) Application.OnBackgroundActivated-Methode (wird häufig in C# als App.OnBackgroundActivatedangezeigt) |
Weitere Informationen finden Sie unter OnActivated, OnBackgroundActivated und andere Aktivierungsbehandlungsmethoden. |
(Windows.UI.Xaml) Application.OnCachedFileUpdaterActivated-Methode (wird häufig in C# als App.OnCachedFileUpdaterActivatedangezeigt) |
Weitere Informationen finden Sie unter OnActivated, OnBackgroundActivated und andere Aktivierungsbehandlungsmethoden. |
(Windows.UI.Xaml) Application.OnFileActivated-Methode (wird häufig in C# als App.OnFileActivatedangezeigt) |
Siehe Dateitypzuordnung und OnActivated, OnBackgroundActivated und andere Aktivierungsbehandlungsmethoden. |
(Windows.UI.Xaml) Application.OnFileOpenPickerActivated-Methode (wird häufig in C# als App.OnFileOpenPickerActivatedangezeigt) |
Weitere Informationen finden Sie unter OnActivated, OnBackgroundActivated und andere Aktivierungsbehandlungsmethoden. |
(Windows.UI.Xaml) Application.OnFileSavePickerActivated-Methode (wird häufig in C# als App.OnFileSavePickerActivatedangezeigt) |
Weitere Informationen finden Sie unter OnActivated, OnBackgroundActivated und andere Aktivierungsbehandlungsmethoden. |
(Windows.UI.Xaml) Application.OnSearchActivated-Methode (wird häufig in C# als App.OnSearchActivatedangezeigt) |
Weitere Informationen finden Sie unter OnActivated, OnBackgroundActivated und andere Aktivierungsbehandlungsmethoden. |
(Windows.UI.Xaml) Application.OnShareTargetActivated-Methode (wird häufig in C# als App.OnShareTargetActivatedangezeigt) |
Weitere Informationen finden Sie unter OnActivated, OnBackgroundActivated und andere Aktivierungsbehandlungsmethoden. |
| (Windows.UI.Xaml) Window.Current-Eigenschaft | Veraltet, und gibt zurück null. Eine Alternative finden Sie unter Ändern von Window.Current in App.Window. |
(Windows.UI.Xaml) Window.Dispatcher-Eigenschaft (häufig in C# geschrieben als Window.Current.Dispatcher) |
(Microsoft.UI.Xaml) Window.DispatcherQueue-Eigenschaft |
| (Windows.UI.Xaml.Controls) ContentDialog-Klasse | (Microsoft.UI.Xaml.Controls) ContentDialog wird unterstützt, aber Sie müssen die XamlRoot-Eigenschaft festlegen. Weitere Informationen finden Sie unter ContentDialog und Popup. |
| (Windows.UI.Xaml.Controls) InkCanvas-Klasse | In Windows App SDK 1.0 nicht unterstützt. |
| (Windows.UI.Xaml.Controls) MediaElement-Klasse | In Windows App SDK 1.0 nicht unterstützt. |
| (Windows.UI.Xaml.Controls.Maps) MapControl-Klasse | In Windows App SDK 1.0 nicht unterstützt. |
| (Windows.UI.Xaml.Controls.Primitives) Popup-Klasse | (Microsoft.UI.Xaml.Controls.Primitives) Popup wird unterstützt, aber Sie müssen die XamlRoot-Eigenschaft festlegen. Weitere Informationen finden Sie unter ContentDialog und Popup. |
| (Windows.UI.Xaml.Media) AcrylicBrush.BackgroundSource-Eigenschaft | In der Windows App SDK (Microsoft.UI.Xaml.Media) AcrylicBrush immer Beispiele aus dem App-Inhalt. Weitere Informationen finden Sie unter AcrylicBrush.BackgroundSource-Eigenschaft. |
C++/WinRT. co_await winrt.resume_foreground(this->Dispatcher()); |
Weitere Informationen finden Sie unter Migrieren von winrt.resume_foreground |
Drittanbieterbibliotheken
In diesem Abschnitt werden verschiedene Bibliotheken dokumentiert, die in UWP unterstützt wurden und bei Verwendung von WinUI 3 geändert werden müssen.
| UWP | Windows-App-SDK |
|---|---|
| OneDrive SDK | Microsoft Graph-SDK |
Zusammenarbeit auf GitHub
Die Quelle für diesen Inhalt finden Sie auf GitHub, wo Sie auch Issues und Pull Requests erstellen und überprüfen können. Weitere Informationen finden Sie in unserem Leitfaden für Mitwirkende.
Windows developer
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für