Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En este tema se proporciona una asignación de las API de UWP a sus equivalentes de SDK de Aplicaciones para Windows. En algunos casos, la asignación no es exclusiva; cualquiera de las plataformas puede tener más o menos funcionalidades que la otra para un espacio de nombres o una clase.
Existen diferencias en los nombres de los espacios de nombres y las clases (incluidos los controles de interfaz de usuario) entre las dos plataformas. En muchos casos, es tan fácil como cambiar un nombre de espacio de nombres y luego el código se compilará. A veces, un nombre de clase o API ha cambiado, así como el nombre del espacio de nombres. Otras veces, el mapeo requiere un poco más de trabajo y, en raras ocasiones, requiere un cambio de enfoque.
Cómo usar la tabla. En primer lugar, busque el nombre del elemento de clase que está usando. Se enumeran los miembros siempre que el mapeo sea más complicado que un simple cambio de nombre de clase o de espacio de nombres. Si el miembro no aparece en la lista, busque el nombre de la clase que está usando. Se enumeran las clases siempre que el mapeo sea más complicado que simplemente cambiar el nombre del espacio de nombres (para obtener instrucciones específicas, consulte las guías del área de funciones). Si la clase no aparece en la lista, la asignación es solo un cambio de espacio de nombres. Primero, busque el nombre del espacio de nombres de la clase y luego descubrirá el nombre del espacio de nombres equivalente en el SDK para aplicaciones de Windows. La clase estará en ese espacio de nombres. Si el espacio de nombres no aparece en la lista, el nombre no habrá cambiado.
| UWP | SDK para aplicaciones de Windows |
|---|---|
| (Windows.ApplicationModel.Activation) clase LaunchActivatedEventArgs | (Microsoft.UI.Xaml) Clase LaunchActivatedEventArgs ; por ejemplo, en App.OnLaunched. |
| (Windows.ApplicationModel.Background) Clase BackgroundTaskBuilder | (Microsoft.Windows.ApplicationModel.Background)Clase BackgroundTaskBuilder. Consulte Uso de tareas en segundo plano en aplicaciones de Windows. |
| (Windows.ApplicationModel.Core) Método CoreApplication.CreateNewView | Método AppWindow.Create (Microsoft.UI.Windowing) |
| (Windows.ApplicationModel.Core) class CoreApplicationViewTitleBar | (Microsoft.UI.Windowing) Clase AppWindowTitleBar |
| (Windows.ApplicationModel.Core) Propiedad CoreApplicationViewTitleBar.ExtendViewIntoTitleBar | (Microsoft.UI.Windowing) propiedad AppWindowTitleBar.ExtendsContentIntoTitleBar. La plataforma sigue dibujando los botones Minimizar/Maximizar/Cerrar para usted e informa sobre la oclusión. |
| (Windows.ApplicationModel.Core) Propiedad CoreApplicationViewTitleBar.Height | Microsoft.UI.Windowing (AppWindowTitleBar.Height) propiedad |
| Propiedad Windows.ApplicationModel.CoreCoreApplicationViewTitleBar.SystemOverlayLeftInset | (Microsoft.UI.Windowing) propiedad AppWindowTitleBar.LeftInset |
| Propiedad (Windows.ApplicationModel.Core) CoreApplicationViewTitleBar.SystemOverlayRightInset | (Microsoft.UI.Windowing) Propiedad AppWindowTitleBar.RightInset |
| Windows.ApplicationModel.Resources.Core namespace | Microsoft.Windows.ApplicationModel.Resources. Consulte Migración de MRT a MRT Core. |
| (Windows.ApplicationModel.Resources.Core) Método ResourceContext.GetForCurrentView | (Microsoft.Windows.ApplicationModel.Resources) Método ResourceManager.CreateResourceContext . Consulte ResourceContext.GetForCurrentView y ResourceContext.GetForViewIndependentUse. |
| (Windows.ApplicationModel.Resources.Core) Método ResourceContext.GetForViewIndependentUse | (Microsoft.Windows.ApplicationModel.Resources) Método ResourceManager.CreateResourceContext . Consulte ResourceContext.GetForCurrentView y ResourceContext.GetForViewIndependentUse. |
| (Windows.ApplicationModel.Resources.Core) ResourceManager.Current propiedad | Cree un nuevo objeto ResourceManager (Microsoft.Windows.ApplicationModel.Resources). Consulte Clase ResourceManager. |
| (Windows.ApplicationModel.Resources.Core) Evento ResourceQualifierObservableMap.MapChanged | Detecte los cambios en el entorno por sí mismo. Consulte Cambio del valor del calificador de recursos. |
| PrintManager (Windows.Graphics.Printing) clase | No se admite en SDK de Aplicaciones para Windows 1.0. |
| (Windows.Media.Capture) Clase CameraCaptureUI | (Microsoft.Windows.Media.Capture) CameraCaptureUI class |
| (Windows.Security.Authentication.Web) Clase WebAuthenticationBroker | (Microsoft.Security.Authentication.OAuth) clase OAuth2Manager (compatible con Windows App SDK 1.7 y versiones posteriores). Consulte Implementación de la funcionalidad de OAuth en aplicaciones de Windows para obtener más información sobre el uso de OAuth2Manager y las API relacionadas para realizar la autenticación de OAuth 2.0. Consulte GitHub para obtener una aplicación de ejemplo completa. |
| (Windows.Storage.Pickers) Clases FileOpenPicker, FileSavePicker y FolderPicker | Compatible, pero debe usar la interfaz IInitializeWithWindow . Consulte MessageDialog y Pickers. |
| (Windows.System.Display) Clase DisplayRequest | No se admite en SDK de Aplicaciones para Windows 1.0. |
| Espacio de nombres Windows.UI.Composition | Espacio de nombres Microsoft.UI.Composition |
| Windows.UI.Core Clase CoreDispatcher | (Microsoft.UI.Dispatching) DispatcherQueue clase. Consulte Cambiar CoreDispatcher por DispatcherQueue. |
| (Windows.UI.Core) Método CoreDispatcher.RunAsync | (Microsoft.UI.Dispatching) Método DispatcherQueue.TryEnqueue . Consulte Cambiar RunAsync a TryEnqueue. |
| (Windows.UI.Core) Clase CoreWindow | (Microsoft.UI.Windowing) AppWindow clase. Consulte Migración de la funcionalidad basada en ventanas. |
(Windows.UI.Core) Propiedad CoreWindow.Bounds (normalmente aparece en C# como CoreWindow.GetForCurrentThread.Bounds) |
(Microsoft.UI.Windowing) AppWindow.Size property |
| (Windows.UI.Core) Método CoreWindow.GetForCurrentThread | No hay correspondencia directa uno a uno con una API del SDK de aplicaciones de Windows. Al usar XAML, puedes obtener Window.AppWindow para obtener la aplicaciónWindow asociada a una ventana XAML, pero una aplicación debe almacenar en caché la ventana o AppWindow si quiere acceder a ella desde algún lugar que no tenga acceso de otro modo. Se recomienda almacenar en caché y exponer la ventana en el objeto App . |
| Método CoreWindow.Activate (Windows.UI.Core) | Método AppWindow.Show (Microsoft.UI.Windowing) |
| (Windows.UI.Core) Propiedad CoreWindow.Dispatcher | (Microsoft.UI.Xaml) Propiedad Window.DispatcherQueue. Consulte Cambiar CoreWindow.Dispatcher a Window.DispatcherQueue. |
| (Windows.UI.Core) CoreWindow.SizeChanged evento | (Microsoft.UI.Windowing) Método AppWindowChangedEventArgs.DidSizeChange |
| (Windows.UI.Core) Clase SystemNavigationManager (botón de retroceso global) | No está soportado. Implemente un botón Atrás dentro de su propia interfaz de usuario. Consulte Migración de la aplicación de ejemplo PhotoLab de UWP (C#) al SDK para aplicaciones de Windows. |
| (Windows.UI.Core) WindowSizeChangedEventArgs clase | (Microsoft.UI.Xaml) Clase WindowSizeChangedEventArgs ; por ejemplo, en un controlador para (Microsoft.UI.Xaml) Window.SizeChanged. |
| (Windows.UI.Popups) Clase MessageDialog | Compatible, pero debe usar la interfaz IInitializeWithWindow . Consulte MessageDialog y Pickers. |
| (Windows.UI.Text.Core) Clase CoreTextServicesManager | Se admite solo en Windows 11. |
| (Windows.UI.ViewManagement) Evento AccessibilitySettings.HighContrastChanged | (Microsoft.UI.System) evento ThemeSettings.Changed |
| Clase ApplicationView (Windows.UI.ViewManagement) | Clase AppWindow (Microsoft.UI.Windowing) |
| (Windows.UI.ViewManagement) propiedad ApplicationView.Title | Propiedad Microsoft.UI.Windowing (AppWindow.Title) |
| Método ApplicationView.TryConsolidateAsync (Windows.UI.ViewManagement) | Método AppWindow.Destroy (Microsoft.UI.Windowing) |
| (Windows.UI.ViewManagement) Método ApplicationView.TryEnterFullScreenMode | Método AppWindow.SetPresenter (Microsoft.UI.Windowing) con AppWindowPresenterKind.FullScreen |
| (Windows.UI.ViewManagement) Método ApplicationView.TryEnterViewModeAsync con ApplicationViewMode.CompactOverlay | Método AppWindow.SetPresenter (Microsoft.UI.Windowing) con AppWindowPresenterKind.CompactOverlay |
| Método ApplicationView.TryResizeView (Windows.UI.ViewManagement) | Método AppWindow.Resize (Microsoft.UI.Windowing) |
| (Windows.UI.ViewManagement) Campo ApplicationViewMode.CompactOverlay | (Microsoft.UI.Windowing) AppWindowPresenterKind.CompactOverlay del campo |
| (Windows.UI.ViewManagement) Clase ApplicationViewTitleBar | (Microsoft.UI.Windowing) Clase AppWindowTitleBar |
| (Windows.UI.ViewManagement) Campo ApplicationViewWindowingMode.FullScreen | (Microsoft.UI.Windowing) Campo AppWindowPresenterKind.FullScreen |
| Clase AppWindow (Windows.UI.WindowManagement) | (Microsoft.UI.Windowing) AppWindow clase |
| Evento AppWindow.Changed (Windows.UI.WindowManagement) | (Microsoft.UI.Windowing) Evento Microsoft.UI.Windowing.AppWindow.Changed |
| Método AppWindow.CloseAsync (Windows.UI.WindowManagement) | Método AppWindow.Destroy (Microsoft.UI.Windowing) |
| Método AppWindow.GetPlacement (Windows.UI.WindowManagement) | (Microsoft.UI.Windowing) Propiedad AppWindow.Position |
| Métodos Appwindow.RequestMoveXxx (Windows.UI.WindowManagement) | Método AppWindow.Move (Microsoft.UI.Windowing) |
| Método AppWindow.RequestSize (Windows.UI.WindowManagement) | Método AppWindow.Resize (Microsoft.UI.Windowing) |
| (Windows.UI.WindowManagement) Propiedad AppWindow.Title | (Microsoft.UI.Windowing) Propiedad AppWindow.Title |
| Método AppWindow.TryCreateAsync (Windows.UI.WindowManagement) | Método AppWindow.Create (Microsoft.UI.Windowing) |
| Método AppWindow.TryShowAsync (Windows.UI.WindowManagement) | Método AppWindow.Show (Microsoft.UI.Windowing) |
| (Windows.UI.WindowManagement) Método AppWindowChangedEventArgs.DidSizeChange | Método AppWindowChangedEventArgs.DidSizeChange (Microsoft.UI.Windowing) |
| (Windows.UI.WindowManagement) Propiedad AppWindowPlacement.Size | (Microsoft.UI.Windowing) AppWindow.Size property |
| (Windows.UI.WindowManagement) Campo AppWindowPresentationKind.CompactOverlay | (Microsoft.UI.Windowing) AppWindowPresenterKind.CompactOverlay del campo |
| (Windows.UI.WindowManagement) AppWindowPresentationKind.FullScreen campo | (Microsoft.UI.Windowing) Campo AppWindowPresenterKind.FullScreen |
| Método AppWindowPresenter.RequestPresentation (Windows.UI.WindowManagement) | Método AppWindow.SetPresenter (Microsoft.UI.Windowing) |
| (Windows.UI.WindowManagement) Clase AppWindowTitleBar | (Microsoft.UI.Windowing) Clase AppWindowTitleBar |
| (Windows.UI.WindowManagement) AppWindowTitleBar.GetPreferredVisibility | No hay una asignación directa personalizada en una API del SDK para aplicaciones de Windows |
| (Windows.UI.WindowManagement) AppWindowTitleBar.GetTitleBarOcclusions | (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset y RightInset, junto con Height, proporcionan la misma información. |
| (Windows.UI.WindowManagement) AppWindowTitleBar.SetPreferredVisibility | No hay una asignación directa personalizada en una API del SDK para aplicaciones de Windows |
| (Windows.UI.WindowManagement) Propiedad AppWindowTitleBarOcclusion | (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset y RightInset, junto con Height, proporcionan la misma información. |
| (Windows.UI.WindowManagement) AppWindowTitleBarVisibility | No hay una asignación directa personalizada en una API del SDK para aplicaciones de Windows |
| Espacio de nombres Windows.UI.Xaml | Espacio de nombres Microsoft.UI.Xaml |
(Windows.UI.Xaml) Método Application.OnActivated (normalmente aparece en C# como App.OnActivated) |
Consulte OnActivated, OnBackgroundActivated y otros métodos de control de activación. |
(Windows.UI.Xaml) Método Application.OnBackgroundActivated (normalmente aparece en C# como App.OnBackgroundActivated) |
Consulte OnActivated, OnBackgroundActivated y otros métodos de control de activación. |
(Windows.UI.Xaml) Método Application.OnCachedFileUpdaterActivated (normalmente aparece en C# como App.OnCachedFileUpdaterActivated) |
Consulte OnActivated, OnBackgroundActivated y otros métodos de control de activación. |
(Windows.UI.Xaml) Método Application.OnFileActivated (normalmente aparece en C# como App.OnFileActivated) |
Consulte Asociación de tipos de archivo y OnActivated, OnBackgroundActivated y otros métodos de control de activación. |
(Windows.UI.Xaml) Método Application.OnFileOpenPickerActivated (normalmente aparece en C# como App.OnFileOpenPickerActivated) |
Consulte OnActivated, OnBackgroundActivated y otros métodos de control de activación. |
(Windows.UI.Xaml) Método Application.OnFileSavePickerActivated (normalmente aparece en C# como App.OnFileSavePickerActivated) |
Consulte OnActivated, OnBackgroundActivated y otros métodos de control de activación. |
(Windows.UI.Xaml) Método Application.OnSearchActivated (normalmente aparece en C# como App.OnSearchActivated) |
Consulte OnActivated, OnBackgroundActivated y otros métodos de control de activación. |
(Windows.UI.Xaml) Método Application.OnShareTargetActivated (normalmente aparece en C# como App.OnShareTargetActivated) |
Consulte OnActivated, OnBackgroundActivated y otros métodos de control de activación. |
| (Windows.UI.Xaml) Propiedad Window.Current | Obsoleto y devuelve null. Para obtener una alternativa, consulte Cambiar Window.Current a App.Window. |
(Windows.UI.Xaml) Propiedad Window.Dispatcher (escrita normalmente en C# como Window.Current.Dispatcher) |
(Microsoft.UI.Xaml) Window.DispatcherQueue propiedad |
| (Windows.UI.Xaml.Controls) Clase ContentDialog | (Microsoft.UI.Xaml.Controls) ContentDialog es compatible, pero debe establecer su propiedad XamlRoot . Consulte ContentDialog y Popup. |
| (Windows.UI.Xaml.Controls) InkCanvas clase | No se admite en SDK de Aplicaciones para Windows 1.0. |
| (Windows.UI.Xaml.Controls) MediaElement clase | No se admite en SDK de Aplicaciones para Windows 1.0. |
| (Windows.UI.Xaml.Controls.Maps) MapControl clase | (Microsoft.UI.Xaml.Controls) MapControl clase |
| (Windows.UI.Xaml.Controls.Primitives) Clase emergente | Se admite Microsoft.UI.Xaml.Controls.PrimitivesPopup, pero debe establecer su propiedad XamlRoot. Consulte ContentDialog y Popup. |
| (Windows.UI.Xaml.Media) AcrylicBrush.BackgroundSource propiedad | En el SDK de aplicaciones de Windows, el AcrylicBrush (Microsoft.UI.Xaml.Media) siempre toma muestras del contenido de la aplicación. Consulte la propiedad AcrylicBrush.BackgroundSource. |
C++/WinRT. co_await winrt.resume_foreground(this->Dispatcher()); |
Consulte Migración de winrt.resume_foreground |
Bibliotecas de terceros
En esta sección se documentan varias bibliotecas que eran compatibles con UWP y que deben cambiarse al usar WinUI 3.
| UWP | SDK para aplicaciones de Windows |
|---|---|
| OneDrive SDK | SDK de Microsoft Graph |