Memetakan API dan pustaka UWP ke SDK Aplikasi Windows
Topik ini menyediakan pemetaan API UWP ke SDK Aplikasi Windows yang setara. Dalam beberapa kasus pemetaan tidak satu-ke-satu; salah satu platform mungkin memiliki lebih banyak atau kurang fungsionalitas daripada yang lain untuk namespace layanan atau kelas.
Ada perbedaan dalam nama namespace layanan dan kelas (termasuk kontrol UI) antara kedua platform. Dalam banyak kasus, semampu mengubah nama namespace layanan dan kemudian kode Anda akan dikompilasi. Terkadang, nama kelas atau API telah berubah serta nama namespace layanan. Di lain waktu, pemetaan membutuhkan sedikit lebih banyak pekerjaan, dan dalam kasus yang jarang terjadi membutuhkan perubahan pendekatan.
Cara menggunakan tabel. Pertama, cari nama anggota kelas yang Anda gunakan. Anggota dicantumkan setiap kali pemetaan lebih rumit daripada perubahan nama kelas sederhana atau nama namespace layanan. Jika anggota Anda tidak tercantum, cari nama kelas yang Anda gunakan. Kelas dicantumkan setiap kali pemetaan lebih rumit daripada hanya mengubah nama namespace (untuk panduan tertentu, lihat Panduan area fitur). Jika kelas Anda tidak tercantum, pemetaan hanyalah perubahan namespace. Jadi, temukan nama namespace kelas Anda lalu Anda akan menemukan nama namespace SDK Aplikasi Windows yang setara. Kelas Anda akan berada di namespace layanan tersebut. Jika namespace Anda tidak tercantum, maka namanya belum berubah.
| UWP | SDK Aplikasi Windows |
|---|---|
| (Windows.ApplicationModel.Activation) Kelas LaunchActivatedEventArgs | (Microsoft.UI.Xaml) Kelas LaunchActivatedEventArgs ; misalnya, di App.OnLaunched. |
| (Windows.ApplicationModel.Core) CoreApplication.CreateNewView metode | (Microsoft.UI.Windowing) Metode AppWindow.Create |
| (Windows.ApplicationModel.Core) Kelas CoreApplicationViewTitleBar | (Microsoft.UI.Windowing) Kelas AppWindowTitleBar |
| (Windows.ApplicationModel.Core) CoreApplicationViewTitleBar.ExtendViewIntoTitleBar properti | (Microsoft.UI.Windowing) Properti AppWindowTitleBar.ExtendsContentIntoTitleBar . Platform terus menggambar tombol Minimalkan/Maksimalkan/Tutup untuk Anda, dan melaporkan informasi oklusi. |
| (Windows.ApplicationModel.Core) CoreApplicationViewTitleBar.Height properti | (Microsoft.UI.Windowing) Properti AppWindowTitleBar.Height |
| (Windows.ApplicationModel.Core) CoreApplicationViewTitleBar.SystemOverlayLeftInset properti | (Microsoft.UI.Windowing) Properti AppWindowTitleBar.LeftInset |
| (Windows.ApplicationModel.Core) CoreApplicationViewTitleBar.SystemOverlayRightInset properti | (Microsoft.UI.Windowing) Properti AppWindowTitleBar.RightInset |
| Namespace Layanan Windows.ApplicationModel.Resources.Core | Microsoft.Windows.ApplicationModel.Resources. Lihat migrasi MRT ke MRT Core. |
| (Windows.ApplicationModel.Resources.Core) Metode ResourceContext.GetForCurrentView | (Microsoft.Windows.ApplicationModel.Resources) Metode ResourceManager.CreateResourceContext . Lihat ResourceContext.GetForCurrentView, dan ResourceContext.GetForViewIndependentUse. |
| (Windows.ApplicationModel.Resources.Core) ResourceContext.GetForViewIndependentUse metode | (Microsoft.Windows.ApplicationModel.Resources) Metode ResourceManager.CreateResourceContext . Lihat ResourceContext.GetForCurrentView, dan ResourceContext.GetForViewIndependentUse. |
| (Windows.ApplicationModel.Resources.Core) Properti ResourceManager.Current | Buat objek ResourceManager (Microsoft.Windows.ApplicationModel.Resources) baru. Lihat Kelas ResourceManager. |
| (Windows.ApplicationModel.Resources.Core) Peristiwa ResourceQualifierObservableMap.MapChanged | Deteksi perubahan lingkungan untuk diri Anda sendiri. Lihat Perubahan nilai kualifikasi sumber daya. |
| (Windows.Graphics.Printing) Kelas PrintManager | Tidak didukung di SDK Aplikasi Windows 1.0. |
| (Windows.Media.Capture) Kelas CameraCaptureUI | Tidak didukung di SDK Aplikasi Windows 1.0. |
| (Windows.Security.Authentication.Web) Kelas WebAuthenticationBroker | Tidak didukung di SDK Aplikasi Windows 1.0. |
| (Windows.Storage.Pickers) Kelas FileOpenPicker, FileSavePicker, dan FolderPicker | Didukung, tetapi Anda harus menggunakan antarmuka IInitializeWithWindow. Lihat MessageDialog, dan Pemilih. |
| (Windows.System.Display) Kelas DisplayRequest | Tidak didukung di SDK Aplikasi Windows 1.0. |
| Namespace Windows.UI.Composition | Namespace Microsoft.UI.Composition |
| (Windows.UI.Core) Kelas CoreDispatcher | (Microsoft.UI.Dispatching) Kelas DispatcherQueue . Lihat Mengubah CoreDispatcher menjadi DispatcherQueue. |
| (Windows.UI.Core) Metode CoreDispatcher.RunAsync | (Microsoft.UI.Dispatching) Metode DispatcherQueue.TryEnqueue . Lihat Mengubah RunAsync menjadi TryEnqueue. |
| (Windows.UI.Core) Kelas CoreWindow | (Microsoft.UI.Windowing) Kelas AppWindow . Lihat Migrasi fungsionalitas windowing. |
(Windows.UI.Core) Properti CoreWindow.Bounds (biasanya muncul di C# sebagai CoreWindow.GetForCurrentThread.Bounds) |
(Microsoft.UI.Windowing) Properti AppWindow.Size |
| (Windows.UI.Core) Metode CoreWindow.GetForCurrentThread | Tidak ada pemetaan langsung 1:1 ke API SDK Aplikasi Windows. Saat menggunakan XAML, Anda bisa mendapatkan Window.AppWindow untuk mendapatkan AppWindow yang terkait dengan Jendela XAML, tetapi aplikasi perlu menyimpan cache Jendela atau AppWindow jika ingin mengaksesnya dari suatu tempat yang tidak memiliki akses. Kami merekomendasikan penembolokan dan mengekspos Jendela pada objek Aplikasi . |
| (Windows.UI.Core) Metode CoreWindow.Activate | (Microsoft.UI.Windowing) Metode AppWindow.Show |
| (Windows.UI.Core) Properti CoreWindow.Dispatcher | (Microsoft.UI.Xaml) properti Window.DispatcherQueue . Lihat Mengubah CoreWindow.Dispatcher ke Window.DispatcherQueue. |
| (Windows.UI.Core) Peristiwa CoreWindow.SizeChanged | (Microsoft.UI.Windowing) Metode AppWindowChangedEventArgs.DidSizeChange |
| (Windows.UI.Core) Kelas SystemNavigationManager (tombol kembali global) | Tidak didukung. Terapkan tombol kembali dalam UI Anda sendiri. Lihat Migrasi SDK Aplikasi Windows aplikasi sampel UWP PhotoLab (C#). |
| (Windows.UI.Core) Kelas WindowSizeChangedEventArgs | (Microsoft.UI.Xaml) Kelas WindowSizeChangedEventArgs; misalnya, dalam handler untuk (Microsoft.UI.Xaml) Window.SizeChanged. |
| (Windows.UI.Popups) Kelas MessageDialog | Didukung, tetapi Anda harus menggunakan antarmuka IInitializeWithWindow. Lihat MessageDialog, dan Pemilih. |
| (Windows.UI.Text.Core) Kelas CoreTextServicesManager | Hanya didukung pada Windows 11. |
| (Windows.UI.ViewManagement) Kelas ApplicationView | (Microsoft.UI.Windowing) Kelas AppWindow |
| (Windows.UI.ViewManagement) Properti ApplicationView.Title | (Microsoft.UI.Windowing) Properti AppWindow.Title |
| (Windows.UI.ViewManagement) Metode ApplicationView.TryConsolidateAsync | (Microsoft.UI.Windowing) Metode AppWindow.Destroy |
| (Windows.UI.ViewManagement) Metode ApplicationView.TryEnterFullScreenMode | (Microsoft.UI.Windowing) Metode AppWindow.SetPresenter dengan AppWindowPresenterKind.FullScreen |
| (Windows.UI.ViewManagement) Metode ApplicationView.TryEnterViewModeAsync dengan ApplicationViewMode.CompactOverlay | (Microsoft.UI.Windowing) Metode AppWindow.SetPresenter dengan AppWindowPresenterKind.CompactOverlay |
| (Windows.UI.ViewManagement) Metode ApplicationView.TryResizeView | (Microsoft.UI.Windowing) Metode AppWindow.Resize |
| (Windows.UI.ViewManagement) Bidang ApplicationViewMode.CompactOverlay | (Microsoft.UI.Windowing) Bidang AppWindowPresenterKind.CompactOverlay |
| (Windows.UI.ViewManagement) Kelas ApplicationViewTitleBar | (Microsoft.UI.Windowing) Kelas AppWindowTitleBar |
| (Windows.UI.ViewManagement) Bidang ApplicationViewWindowingMode.FullScreen | (Microsoft.UI.Windowing) Bidang AppWindowPresenterKind.FullScreen |
| (Windows.UI.WindowManagement) Kelas AppWindow | (Microsoft.UI.Windowing) Kelas AppWindow |
| (Windows.UI.WindowManagement) Peristiwa AppWindow.Changed | (Microsoft.UI.Windowing) Peristiwa Microsoft.UI.Windowing.AppWindow.Changed |
| (Windows.UI.WindowManagement) Metode AppWindow.CloseAsync | (Microsoft.UI.Windowing) Metode AppWindow.Destroy |
| (Windows.UI.WindowManagement) Metode AppWindow.GetPlacement | (Microsoft.UI.Windowing) Properti AppWindow.Position |
| (Windows.UI.WindowManagement) Metode Appwindow.RequestMoveXxx | (Microsoft.UI.Windowing) Metode AppWindow.Move |
| (Windows.UI.WindowManagement) Metode AppWindow.RequestSize | (Microsoft.UI.Windowing) Metode AppWindow.Resize |
| (Windows.UI.WindowManagement) Properti AppWindow.Title | (Microsoft.UI.Windowing) Properti AppWindow.Title |
| (Windows.UI.WindowManagement) Metode AppWindow.TryCreateAsync | (Microsoft.UI.Windowing) Metode AppWindow.Create |
| (Windows.UI.WindowManagement) Metode AppWindow.TryShowAsync | (Microsoft.UI.Windowing) Metode AppWindow.Show |
| (Windows.UI.WindowManagement) Metode AppWindowChangedEventArgs.DidSizeChange | (Microsoft.UI.Windowing) Metode AppWindowChangedEventArgs.DidSizeChange |
| (Windows.UI.WindowManagement) Properti AppWindowPlacement.Size | (Microsoft.UI.Windowing) Properti AppWindow.Size |
| (Windows.UI.WindowManagement) Bidang AppWindowPresentationKind.CompactOverlay | (Microsoft.UI.Windowing) Bidang AppWindowPresenterKind.CompactOverlay |
| (Windows.UI.WindowManagement) Bidang AppWindowPresentationKind.FullScreen | (Microsoft.UI.Windowing) Bidang AppWindowPresenterKind.FullScreen |
| (Windows.UI.WindowManagement) Metode AppWindowPresenter.RequestPresentation | (Microsoft.UI.Windowing) Metode AppWindow.SetPresenter |
| (Windows.UI.WindowManagement) Kelas AppWindowTitleBar | (Microsoft.UI.Windowing) Kelas AppWindowTitleBar |
| (Windows.UI.WindowManagement) AppWindowTitleBar.GetPreferredVisibility | Tidak ada pemetaan langsung 1:1 ke API SDK Aplikasi Windows |
| (Windows.UI.WindowManagement) AppWindowTitleBar.GetTitleBarOcclusions | (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset dan RightInset, ditambah dengan Height, memberikan informasi yang sama. |
| (Windows.UI.WindowManagement) AppWindowTitleBar.SetPreferredVisibility | Tidak ada pemetaan langsung 1:1 ke API SDK Aplikasi Windows |
| (Windows.UI.WindowManagement) Properti AppWindowTitleBarOcclusion | (Microsoft.UI.Windowing) AppWindowTitleBar.LeftInset dan RightInset, ditambah dengan Height, memberikan informasi yang sama. |
| (Windows.UI.WindowManagement) AppWindowTitleBarVisibility | Tidak ada pemetaan langsung 1:1 ke API SDK Aplikasi Windows |
| Namespace Windows.UI.Xaml | Namespace Microsoft.UI.Xaml |
(Windows.UI.Xaml) Metode Application.OnActivated (umumnya muncul di C# sebagai App.OnActivated) |
Lihat OnActivated, OnBackgroundActivated, dan metode penanganan aktivasi lainnya. |
(Windows.UI.Xaml) Metode Application.OnBackgroundActivated (biasanya muncul di C# sebagai App.OnBackgroundActivated) |
Lihat OnActivated, OnBackgroundActivated, dan metode penanganan aktivasi lainnya. |
(Windows.UI.Xaml) Application.OnCachedFileUpdaterActivated method (biasanya muncul di C# sebagai App.OnCachedFileUpdaterActivated) |
Lihat OnActivated, OnBackgroundActivated, dan metode penanganan aktivasi lainnya. |
(Windows.UI.Xaml) Metode Application.OnFileActivated (biasanya muncul di C# sebagai App.OnFileActivated) |
Lihat Asosiasi jenis file dan OnActivated, OnBackgroundActivated, dan metode penanganan aktivasi lainnya. |
(Windows.UI.Xaml) Metode Application.OnFileOpenPickerActivated (umumnya muncul di C# sebagai App.OnFileOpenPickerActivated) |
Lihat OnActivated, OnBackgroundActivated, dan metode penanganan aktivasi lainnya. |
(Windows.UI.Xaml) Metode Application.OnFileSavePickerActivated (biasanya muncul di C# sebagai App.OnFileSavePickerActivated) |
Lihat OnActivated, OnBackgroundActivated, dan metode penanganan aktivasi lainnya. |
(Windows.UI.Xaml) Metode Application.OnSearchActivated (biasanya muncul di C# sebagai App.OnSearchActivated) |
Lihat OnActivated, OnBackgroundActivated, dan metode penanganan aktivasi lainnya. |
(Windows.UI.Xaml) Application.OnShareTargetActivated method (biasanya muncul di C# sebagai App.OnShareTargetActivated) |
Lihat OnActivated, OnBackgroundActivated, dan metode penanganan aktivasi lainnya. |
| (Windows.UI.Xaml) Window.Current properti | Tidak digunakan lagi, dan mengembalikan null. Untuk alternatif, lihat Ubah Window.Current ke App.Window. |
(Windows.UI.Xaml) properti Window.Dispatcher (umumnya ditulis dalam C# sebagai Window.Current.Dispatcher) |
(Microsoft.UI.Xaml) Properti Window.DispatcherQueue |
| (Windows.UI.Xaml.Controls) Kelas ContentDialog | (Microsoft.UI.Xaml.Controls) ContentDialog didukung, tetapi Anda harus mengatur properti XamlRoot-nya. Lihat ContentDialog, dan Popup. |
| (Windows.UI.Xaml.Controls) Kelas InkCanvas | Tidak didukung di SDK Aplikasi Windows 1.0. |
| (Windows.UI.Xaml.Controls) Kelas MediaElement | Tidak didukung di SDK Aplikasi Windows 1.0. |
| (Windows.UI.Xaml.Controls.Maps) Kelas MapControl | (Microsoft.UI.Xaml.Controls) Kelas MapControl |
| (Windows.UI.Xaml.Controls.Primitives) Kelas popup | (Popup Microsoft.UI.Xaml.Controls.Primitives) didukung, tetapi Anda harus mengatur properti XamlRoot-nya. Lihat ContentDialog, dan Popup. |
| (Windows.UI.Xaml.Media) Properti AcrylicBrush.BackgroundSource | Dalam SDK Aplikasi Windows, AcrylicBrush (Microsoft.UI.Xaml.Media) selalu mengambil sampel dari konten aplikasi. Lihat properti AcrylicBrush.BackgroundSource. |
C++/WinRT. co_await winrt.resume_foreground(this->Dispatcher()); |
Lihat Memigrasikan winrt.resume_foreground |
Pustaka pihak ketiga
Bagian ini men dokumen berbagai pustaka yang didukung di UWP, dan perlu diubah saat menggunakan WinUI 3.
| UWP | SDK Aplikasi Windows |
|---|---|
| OneDrive SDK | Microsoft Graph SDK |
Lihat Juga
Berkolaborasi dengan kami di GitHub
Sumber untuk konten ini dapat ditemukan di GitHub, yang juga dapat Anda gunakan untuk membuat dan meninjau masalah dan menarik permintaan. Untuk informasi selengkapnya, lihat panduan kontributor kami.
Windows developer
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk