Mengelola file, folder, dan pustaka dengan Windows App SDK

Windows App SDK menyediakan kemampuan manajemen file yang kuat untuk aplikasi paket. Anda dapat menggunakan API dari namespace Windows.Storage, Windows.Storage.Streams, dan Microsoft.Windows.Storage.Pickers untuk membaca dan menulis berbagai format data secara efisien dalam file, serta mengelola file dan folder.

Ada berbagai macam API yang terkait dengan file, folder, pustaka, dan pengaturan untuk aplikasi desktop di Windows yang mulai tersedia sejak Windows 10. Fitur-fitur ini tersedia melalui kombinasi Windows App SDK, Windows Runtime (WinRT), dan .NET API yang disediakan oleh Windows App SDK, Windows SDK, dan .NET SDK.

Menggunakan pemilih Windows App SDK untuk membaca dan menulis data

Ada API pemilih yang tersedia di Windows App SDK versi 1.8 dan yang lebih baru. Topik berikut menyediakan informasi tentang menggunakan API pemilih untuk memungkinkan pengguna membuka dan menyimpan file dan folder di aplikasi Anda:

Topik	Description
Buka file dan folder dengan pemilih di WinUI	Gunakan pemilih file dan folder Windows App SDK untuk memungkinkan pengguna menelusuri dan memilih file atau folder di aplikasi WinUI Anda. API pemilih memberikan pengalaman Windows yang familier yang membantu pengguna menavigasi lokasi penyimpanan perangkat dan cloud mereka. Pelajari cara mengizinkan pengguna memilih file atau folder untuk dibuka menggunakan kelas FileOpenPicker dan FolderPicker .
Menyimpan file menggunakan pemilih antarmuka Windows App SDK di WinUI	Saat membangun aplikasi WinUI dan aplikasi klien Windows lainnya, pengguna sering kali perlu menyimpan file seperti dokumen, gambar, atau konten lainnya ke lokasi tertentu di perangkat mereka. Windows App SDK menyediakan kelas FileSavePicker untuk membuat antarmuka yang konsisten dan mudah digunakan yang memungkinkan pengguna memilih tempat menyimpan file dan apa yang harus dinamai.

Perbedaan utama antara komponen pemilih WinRT dan Windows App SDK

Berikut adalah beberapa perbedaan utama dari Windows.Storage.Pickers WinRT yang digunakan oleh aplikasi UWP:

• Tidak seperti API Windows.Storage.Pickers yang ada yang mengembalikan objek StorageFile dan StorageFolder , API baru ini mengembalikan jalur berbasis string melalui kelas PickFileResult dan PickFolderResult . Ini menyederhanakan API dan menghindari komplikasi dengan kemampuan penyimpanan dalam skenario yang ditingkatkan.
• Demikian pula, properti FileSavePicker.SuggestedSaveFile (yang mengembalikan StorageFile) telah diganti. Fungsionalitasnya sekarang dicakup oleh dua properti string: SuggestedFolder dan SuggestedFileName. Ini memungkinkan Anda untuk menyarankan folder dan nama file untuk dialog simpan.
• Semua pemilih item baru dirancang khusus untuk aplikasi desktop dan menggunakan properti WindowId untuk menautkan pemilih item ke jendela host, menggantikan pola WinRT.Interop.InitializeWithWindow.Initialize.
• Pemilih baru memungkinkan pengembang untuk menggunakannya tanpa memerlukan FileTypeFilter atau FileTypeChoices yang harus ditentukan. Meskipun pemilih file UWP melempar pengecualian ketika properti ini tidak diatur, pemilih file yang baru akan menampilkan semua file secara default ketika pengembang tidak secara eksplisit mengonfigurasi properti ini.
• Lokasi HomeGroup telah dikecualikan dari enum PickerLocationId baru karena tidak lagi didukung mulai windows 10.
• FolderPicker.FileTypeFilter telah dikecualikan karena tidak sesuai secara fungsional untuk pemilihan folder.
• Tidak termasuk metode dan properti yang sudah ditandai sebagai tidak digunakan lagi atau "Jangan gunakan". misalnya, PickSingleFileAndContinue, ContinuationData, ResumePickSingleFileAsync, dll.
• Tidak termasuk metode dan properti untuk mode multi-pengguna, karena API baru saat ini dirancang untuk skenario desktop di mana setiap pengguna memiliki sesi interaktif mereka sendiri, dan setiap sesi sepenuhnya independen dari sesi lain di perangkat. Ini berbeda dengan Xbox atau perangkat multi-pengguna lainnya.

Mengakses data dengan API penyimpanan WinRT

Aplikasi paket memiliki akses ke semua API penyimpanan WinRT yang tersedia untuk aplikasi UWP. Baik Anda memigrasikan aplikasi UWP yang sudah ada atau membuat aplikasi baru, Anda dapat menggunakan API ini untuk membaca dan menulis data. Untuk contoh penggunaan API penyimpanan di aplikasi WinUI, lihat Mengakses file dan folder dengan Windows App SDK dan WINRT API.

Menggunakan API file .NET untuk akses data

Selain API WinRT, aplikasi desktop paket dapat menggunakan API .NET di namespace System.IO untuk membaca dan menulis data. Saat proyek WinUI 3 baru dibuat, filenya Package.appxmanifest berisi pengaturan berikut:

<Capabilities>
  <rescap:Capability Name="runFullTrust" />
</Capabilities>

Menyatakan kemampuan terbatas ini menyediakan akses penuh ke sistem file, registri, dan kemampuan terbatas lainnya. Untuk informasi selengkapnya, lihat Deklarasi kemampuan terbatas. Dengan kata lain, aplikasi memiliki akses yang sama ke sistem file seperti aplikasi desktop .NET lainnya saat menggunakan API file .NET.

Untuk contoh penggunaan API .NET di aplikasi WinUI, lihat Mengakses file dan folder dengan Windows App SDK dan .NET API.

Sumber daya tambahan untuk bekerja dengan file dan folder

Jika Anda mengembangkan aplikasi WinUI paket, API penyimpanan WinRT dapat menjadi alat yang ampuh untuk membaca dan menulis data. Topik UWP berikut memberikan banyak informasi bagi pengembang yang ingin memanfaatkan API ini di aplikasi mereka.

Topik	Description
Menghitung dan mengkueri file dan folder	Akses file dan folder di folder, pustaka, perangkat, atau lokasi jaringan. Anda juga dapat mengkueri file dan folder di lokasi dengan membuat kueri file dan folder.
Membuat, menulis, dan membaca file	Membaca dan menulis file menggunakan objek StorageFile .
Praktik terbaik untuk menulis ke file	Pelajari praktik terbaik untuk menggunakan berbagai metode penulisan file dari kelas FileIO dan PathIO .
Dapatkan properti file	Dapatkan properti—tingkat atas, dasar, dan diperluas—untuk file yang diwakili oleh objek StorageFile .
Mengakses konten HomeGroup	Akses konten yang disimpan di folder GrupRumah pengguna, termasuk gambar, musik, dan video.
Menentukan ketersediaan file Microsoft OneDrive	Tentukan apakah file Microsoft OneDrive tersedia menggunakan properti StorageFile.IsAvailable .
File-file dan folder di pustaka Musik, Gambar, serta Video	Tambahkan folder musik, gambar, atau video yang ada ke pustaka yang sesuai. Anda juga dapat menghapus folder dari pustaka, mendapatkan daftar folder di pustaka, dan menemukan foto, musik, dan video yang disimpan.
Melacak file dan folder yang baru-baru ini digunakan	Lacak file yang sering diakses pengguna Anda dengan menambahkannya ke daftar aplikasi yang terakhir digunakan (MRU). Platform ini mengelola MRU untuk Anda dengan mengurutkan item berdasarkan kapan item terakhir diakses, dan dengan menghapus item terlama saat batas 25 item daftar tercapai. Semua aplikasi memiliki MRU sendiri.
Lacak perubahan sistem file di latar belakang	Lacak perubahan pada sistem file, bahkan saat aplikasi tidak berjalan.
Mengakses kartu SD	Anda dapat menyimpan dan mengakses data yang tidak penting pada kartu microSD opsional, terutama pada perangkat seluler bersifat murah yang memiliki penyimpanan internal terbatas.
Akses cepat ke properti file	Kumpulkan daftar file dan propertinya secara efisien dari pustaka untuk digunakan melalui WINDOWS Runtime API.

Lihat juga

Mengakses file dan folder dengan Windows App SDK dan WinRT API

Mengakses file dan folder dengan Windows App SDK dan .NET API

System.IO