Mengelola file, folder, dan pustaka dengan Windows App SDK

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

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

Menggunakan alat 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 perangkat dan lokasi storage cloud mereka. Pelajari cara mengizinkan pengguna memilih file atau folder untuk dibuka menggunakan kelas FileOpenPicker dan FolderPicker.
Simpan file menggunakan pemilih Windows App SDK pada 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 dinamainya.

Perbedaan utama antara WinRT dan komponen pemilih Windows App SDK

Berikut adalah beberapa perbedaan utama dari WinRT Windows.Storage.Pickers 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 storage dalam skenario yang ditingkatkan.
• Demikian pula, properti FileSavePicker.SuggestedSaveFile (yang mengembalikan properti 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 untuk 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 dari 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.

Akses data dengan WinRT Storage API

Aplikasi yang dikemas 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 3, lihat Access files and folders with Windows App SDK and WinRT APIs.

Menggunakan API file .NET untuk akses data

Selain API WinRT, aplikasi desktop yang dikemas dapat menggunakan API .NET di namespace System.IO untuk membaca dan menulis data. Saat project WinUI baru dibuat, file Package.appxmanifest berisi pengaturan berikut:

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

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

Untuk contoh-contoh mengakses file dan folder dengan API Windows App SDK dan .NET di aplikasi WinUI, lihat Access files and folders with Windows App SDK and .NET APIs.

Sumber daya tambahan untuk bekerja dengan file dan folder

Jika Anda mengembangkan aplikasi WinUI kemasan, WINRT storage API 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 dalam 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 HomeGroup pengguna, termasuk gambar, musik, dan video.
Terminasi 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.
Akses ke kartu SD	Anda dapat menyimpan dan mengakses data yang tidak penting pada kartu microSD opsional, terutama pada perangkat seluler murah yang memiliki penyimpanan internal terbatas.
Akses cepat ke properti file	Kumpulkan daftar file dan propertinya secara efisien dari pustaka untuk digunakan melalui API Windows Runtime.

Lihat juga

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

System.IO