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 dauert die Zuordnung etwas mehr Arbeit, und in seltenen Fällen ist eine Änderung des Ansatzes erforderlich.
Verwenden der Tabelle Suchen Sie zuerst nach dem Namen des verwendeten Klassenmitglieds. Elemente werden aufgelistet, wenn die Zuordnung komplizierter ist als ein einfacher Klassenname oder Namespacename. 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 (spezifische Anleitungen finden Sie in den Featurebereichshandbüchern). 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 , z. B. 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 (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 Ressourcenqualifiziererwertänderung. |
(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. Siehe 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 . Siehe "Change CoreDispatcher to 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 Migration der Fensterfunktionalität. |
(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. Wenn Sie XAML verwenden, können Sie "Window.AppWindow" abrufen, um den einem XAML-Fenster zugeordneten AppWindow abzurufen, aber eine App muss das Fenster oder AppWindow zwischenspeichern, wenn sie von einer beliebigen Stelle aus darauf zugreifen möchte, die andernfalls keinen Zugriff hat. Es wird empfohlen, das Zwischenspeichern und Verfügbarmachen des Window für das App-Objekt zu empfehlen. |
(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 eine Windows App SDK-Migration der UWP PhotoLab-Beispiel-App (C#). |
(Windows.UI.Core) WindowSizeChangedEventArgs-Klasse | (Microsoft.UI.Xaml) WindowSizeChangedEventArgs-Klasse, z. B. 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 Auswahl. |
(Windows.UI.Text.Core) CoreTextServicesManager-Klasse | Wird nur unter 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, 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 Methoden zur Aktivierungsbehandlung. |
(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 zurück null . Eine Alternative finden Sie unter "Change Window.Current to 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) Popupklasse | (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) AcrylBrush.BackgroundSource-Eigenschaft | Im Windows App SDK wird der AcrylBrush (Microsoft.UI.Xaml.Media) immer beispiele aus dem App-Inhalt. Siehe AcrylBrush.BackgroundSource-Eigenschaft. |
C++/WinRT. co_await winrt.resume_foreground(this->Dispatcher()); |
Siehe Migrieren 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 |
Weitere Informationen
Windows developer