Freigeben über


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 1:1; Eine plattform verfügt möglicherweise über mehr oder weniger Funktionen als die andere für einen Namespace oder eine Klasse.

Es gibt Unterschiede bei den Namen von Namespaces und Klassen (einschließlich UI-Steuerelementen) zwischen den beiden Plattformen. In vielen Fällen ist es so einfach wie das Ändern eines Namespacenamens, und der Code wird kompiliert. Manchmal hat sich ein Klassen- oder API-Name sowie der Namespacename geändert. In anderen Fällen erfordert die Zuordnung etwas mehr Arbeit und in seltenen Fällen eine Änderung der Vorgehensweise.

Verwenden der Tabelle Suchen Sie zunächst nach dem Namen des Klassenmitglieds, das Sie verwenden. Mitglieder werden immer dann aufgeführt, wenn die Zuordnung komplizierter ist als eine einfache Änderung des Klassennamens oder des Namens des Namensraums. Wenn Ihr Mitglied nicht aufgeführt ist, suchen Sie nach dem Namen der klasse, die Sie verwenden. Klassen werden aufgelistet, wenn die Zuordnung komplizierter ist, als einfach den Namespacenamen zu ändern (eine bestimmte Anleitung finden Sie im Bereich Feature guides). 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 befindet sich in diesem Namespace. Wenn Ihr Namespace nicht aufgeführt ist, wurde der Name nicht geändert.

UWP Windows App SDK
(Windows.ApplicationModel.Activation) LaunchActivatedEventArgs-Klasse (Microsoft.UI.Xaml) LaunchActivatedEventArgs-Klasse ; Beispiel: in "App.OnLaunched".
(Windows.ApplicationModel.Background) BackgroundTaskBuilder-Klasse (Microsoft.Windows.ApplicationModel.Background) BackgroundTaskBuilder-Klasse . Siehe Verwenden von Hintergrundaufgaben in Windows-Apps.
(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 Okklusionsinformationen.
(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 MRT zur MRT Core-Migration.
(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 (Microsoft.Windows.ApplicationModel.Resources) -ResourceManager-Objekt . Siehe ResourceManager-Klasse.
(Windows.ApplicationModel.Resources.Core) ResourceQualifierObservableMap.MapChanged-Ereignis Erkennen Sie Umgebungsänderungen für sich selbst. Siehe Wertänderung des Ressourcen-Qualifizierers.
(Windows.Graphics.Printing) PrintManager-Klasse In Windows App SDK 1.0 nicht unterstützt.
(Windows.Media.Capture) CameraCaptureUI-Klasse (Microsoft.Windows.Media.Capture) CameraCaptureUI-Klasse
(Windows.Security.Authentication.Web) WebAuthenticationBroker-Klasse (Microsoft.Security.Authentication.OAuth) OAuth2ManagerKlasse (unterstützt in Windows App SDK 1.7 und höher). Weitere Informationen zur Verwendung OAuthManager- und zugehöriger APIs zum Ausführen der OAuth 2.0-Authentifizierung finden Sie unter Implementieren von OAuth-Funktionen in Windows-Apps. Eine vollständige Beispielanwendung finden Sie unter GitHub.
(Windows. Storage. Pickers) FileOpenPicker, FileSavePicker und FolderPicker Klassen Unterstützt, aber Sie müssen die IInitializeWithWindow-Schnittstelle verwenden. Siehe MessageDialog und Pickers.
(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) Klasse DispatcherQueue . Siehe Ändern Sie CoreDispatcher zu DispatcherQueue.
(Windows.UI.Core) CoreDispatcher.RunAsync-Methode (Microsoft.UI.Dispatching) DispatcherQueue.TryEnqueue-Methode . Siehe Change RunAsync to TryEnqueue.
(Windows.UI.Core) CoreWindow-Klasse (Microsoft.UI.Windowing) AppWindow-Klasse . Siehe Windowing-Funktionalitätsmigration.
(Windows.UI.Core) CoreWindow.Bounds-Eigenschaft (häufig in C# als CoreWindow.GetForCurrentThread.Bounds) (Microsoft.UI.Windowing) AppWindow.Size-Eigenschaft
(Windows.UI.Core) CoreWindow.GetForCurrentThread-Methode Keine direkte 1:1-Zuordnung zu einer Windows App SDK-API. Bei der Verwendung von XAML können Sie Window.AppWindow nutzen, um das AppWindow zu erhalten, das einem XAML-Window zugeordnet ist. Eine App muss jedoch das Window oder das AppWindow zwischenspeichern, wenn sie darauf von einem Ort zugreifen möchte, der sonst keinen Zugriff darauf hat. Es wird empfohlen, das Caching und die Bereitstellung des Window im App-Objekt vorzunehmen.
(Windows.UI.Core) CoreWindow.Activate-Methode (Microsoft.UI.Windowing) AppWindow.Show-Methode
(Windows.UI.Core) CoreWindow.Dispatcher-Eigenschaft (Microsoft.UI.Xaml) Window.DispatcherQueue-Eigenschaft. Siehe Change CoreWindow.Dispatcher to Window.DispatcherQueue.
(Windows.UI.Core) CoreWindow.SizeChanged-Ereignis (Microsoft.UI.Windowing) AppWindowChangedEventArgs.DidSizeChange-Methode
(Windows.UI.Core) SystemNavigationManager-Klasse (globale Zurück-Schaltfläche) Nicht unterstützt. Implementieren Sie eine Zurück-Schaltfläche in Ihrer eigenen Benutzeroberfläche. Siehe A Windows App SDK Migration der UWP PhotoLab-Beispiel-App (C#).
(Windows.UI.Core) WindowSizeChangedEventArgs-Klasse (Microsoft.UI.Xaml) WindowSizeChangedEventArgs-Klasse ; Beispiel: 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. Siehe MessageDialog und Pickers.
(Windows.UI.Text.Core) CoreTextServicesManager-Klasse Wird nur für Windows 11 unterstützt.
(Windows.UI.ViewManagement) AccessibilitySettings.HighContrastChanged-Ereignis (Microsoft.UI.System) ThemeSettings.Changed-Ereignis
(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, geben die gleichen Informationen an.
(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, geben die gleichen Informationen an.
(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 (häufig in C# als App.OnActivated) Siehe OnActivated, OnBackgroundActivated und andere Methoden zur Aktivierungsbehandlung.
(Windows.UI.Xaml) Application.OnBackgroundActivated-Methode (häufig in C# als App.OnBackgroundActivated) Siehe OnActivated, OnBackgroundActivated und andere Methoden zur Aktivierungsbehandlung.
(Windows.UI.Xaml) Application.OnCachedFileUpdaterActivated-Methode (häufig in C# als App.OnCachedFileUpdaterActivated) Siehe OnActivated, OnBackgroundActivated und andere Methoden zur Aktivierungsbehandlung.
(Windows.UI.Xaml) Application.OnFileActivated-Methode (häufig in C# als App.OnFileActivated) Siehe Dateitypzuordnung und OnActivated, OnBackgroundActivated und andere Aktivierungshandhabungsmethoden.
(Windows.UI.Xaml) Application.OnFileOpenPickerActivated-Methode (häufig in C# als App.OnFileOpenPickerActivated) Siehe OnActivated, OnBackgroundActivated und andere Methoden zur Aktivierungsbehandlung.
(Windows.UI.Xaml) Application.OnFileSavePickerActivated-Methode (häufig in C# als App.OnFileSavePickerActivated) Siehe OnActivated, OnBackgroundActivated und andere Methoden zur Aktivierungsbehandlung.
(Windows.UI.Xaml) Application.OnSearchActivated-Methode (häufig in C# als App.OnSearchActivated) Siehe OnActivated, OnBackgroundActivated und andere Methoden zur Aktivierungsbehandlung.
(Windows.UI.Xaml) Application.OnShareTargetActivated-Methode (häufig in C# als App.OnShareTargetActivated) Siehe OnActivated, OnBackgroundActivated und andere Methoden zur Aktivierungsbehandlung.
(Windows.UI.Xaml) Window.Current-Eigenschaft Veraltet, und gibt nullzurück. Eine Alternative finden Sie unter Ändern Sie 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, sie müssen jedoch die XamlRoot-Eigenschaft festlegen. Siehe 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 (Microsoft.UI.Xaml.Controls) MapControl-Klasse
(Windows.UI.Xaml.Controls.Primitives) Popup-Klasse (Microsoft.UI.Xaml.Controls.Primitives) Popup wird unterstützt, sie müssen jedoch die XamlRoot-Eigenschaft festlegen. Siehe ContentDialog und Popup.
(Windows.UI.Xaml.Media) AcrylicBrush.BackgroundSource-Eigenschaft Im Windows App SDK wird der Microsoft.UI.Xaml.MediaAcrylicBrush immer aus dem App-Inhalt abgeleitet. Siehe AcrylicBrush.BackgroundSource-Eigenschaft.
C++/WinRT. co_await winrt.resume_foreground(this->Dispatcher()); Siehe Migrate 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

Siehe auch