Membuat, menulis, dan membaca file

API Penting

• Kelas StorageFolder
• Kelas StorageFile
• Kelas FileIO

Membaca dan menulis file menggunakan objek StorageFile .

Nota

 Untuk sampel lengkap, lihat Sampel akses file.

Prasyarat

• Memahami pemrograman asinkron untuk aplikasi WinUI

  Anda dapat mempelajari cara menulis aplikasi asinkron di C#, lihat Memanggil API asinkron di C# atau Visual Basic. Untuk mempelajari cara menulis aplikasi asinkron di C++/WinRT, lihat Operasi konkurensi dan asinkron dengan C++/WinRT.

• Ketahui cara mendapatkan file yang ingin Anda baca, tulis, atau keduanya

  Anda dapat mempelajari cara mendapatkan file dengan menggunakan pemilih file di Buka file dan folder dengan pemilih.

Membuat file

Berikut cara membuat file di folder lokal aplikasi. Jika sudah ada, kami menggantinya.

// Create sample file; replace if exists.
Windows.Storage.StorageFolder storageFolder =
    Windows.Storage.ApplicationData.Current.LocalFolder;
Windows.Storage.StorageFile sampleFile =
    await storageFolder.CreateFileAsync("sample.txt",
        Windows.Storage.CreationCollisionOption.ReplaceExisting);

// MainPage.h
#include <winrt/Windows.Storage.h>
...
Windows::Foundation::IAsyncAction ExampleCoroutineAsync()
{
    // Create a sample file; replace if exists.
    Windows::Storage::StorageFolder storageFolder{ Windows::Storage::ApplicationData::Current().LocalFolder() };
    co_await storageFolder.CreateFileAsync(L"sample.txt", Windows::Storage::CreationCollisionOption::ReplaceExisting);
}

Menulis ke file

Berikut cara menulis ke file yang dapat ditulis pada disk menggunakan kelas StorageFile . Langkah umum pertama untuk setiap cara menulis ke file (kecuali Anda menulis ke file segera setelah membuatnya) adalah mendapatkan file dengan StorageFolder.GetFileAsync.

Windows.Storage.StorageFolder storageFolder =
    Windows.Storage.ApplicationData.Current.LocalFolder;
Windows.Storage.StorageFile sampleFile =
    await storageFolder.GetFileAsync("sample.txt");

// MainPage.h
#include <winrt/Windows.Storage.h>
...
Windows::Foundation::IAsyncAction ExampleCoroutineAsync()
{
    Windows::Storage::StorageFolder storageFolder{ Windows::Storage::ApplicationData::Current().LocalFolder() };
    auto sampleFile{ co_await storageFolder.CreateFileAsync(L"sample.txt", Windows::Storage::CreationCollisionOption::ReplaceExisting) };
    // Process sampleFile
}

Menulis teks ke file

Tulis teks ke file Anda dengan memanggil metode FileIO.WriteTextAsync .

await Windows.Storage.FileIO.WriteTextAsync(sampleFile, "Swift as a shadow");

// MainPage.h
#include <winrt/Windows.Storage.h>
...
Windows::Foundation::IAsyncAction ExampleCoroutineAsync()
{
    Windows::Storage::StorageFolder storageFolder{ Windows::Storage::ApplicationData::Current().LocalFolder() };
    auto sampleFile{ co_await storageFolder.GetFileAsync(L"sample.txt") };
    // Write text to the file.
    co_await Windows::Storage::FileIO::WriteTextAsync(sampleFile, L"Swift as a shadow");
}

Menulis byte ke file dengan menggunakan buffer (2 langkah)

1. Pertama, panggil CryptographicBuffer.ConvertStringToBinary untuk mendapatkan buffer byte (berdasarkan string) yang ingin Anda tulis ke file Anda.

   var buffer = Windows.Security.Cryptography.CryptographicBuffer.ConvertStringToBinary(
       "What fools these mortals be", Windows.Security.Cryptography.BinaryStringEncoding.Utf8);
   

   // MainPage.h
   #include <winrt/Windows.Security.Cryptography.h>
   #include <winrt/Windows.Storage.h>
   #include <winrt/Windows.Storage.Streams.h>
   ...
   Windows::Foundation::IAsyncAction ExampleCoroutineAsync()
   {
       Windows::Storage::StorageFolder storageFolder{ Windows::Storage::ApplicationData::Current().LocalFolder() };
       auto sampleFile{ co_await storageFolder.GetFileAsync(L"sample.txt") };
       // Create the buffer.
       Windows::Storage::Streams::IBuffer buffer{
           Windows::Security::Cryptography::CryptographicBuffer::ConvertStringToBinary(
               L"What fools these mortals be", Windows::Security::Cryptography::BinaryStringEncoding::Utf8)};
       // The code in step 2 goes here.
   }
   

2. Kemudian tulis byte dari buffer Anda ke file Anda dengan memanggil metode FileIO.WriteBufferAsync .

   await Windows.Storage.FileIO.WriteBufferAsync(sampleFile, buffer);
   

   co_await Windows::Storage::FileIO::WriteBufferAsync(sampleFile, buffer);
   

Menulis teks ke file dengan menggunakan aliran (4 langkah)

1. Pertama, buka file dengan memanggil metode StorageFile.OpenAsync . Ini mengembalikan aliran konten file saat operasi terbuka selesai.

   var stream = await sampleFile.OpenAsync(Windows.Storage.FileAccessMode.ReadWrite);
   

   // MainPage.h
   #include <winrt/Windows.Storage.h>
   #include <winrt/Windows.Storage.Streams.h>
   ...
   Windows::Foundation::IAsyncAction ExampleCoroutineAsync()
   {
       Windows::Storage::StorageFolder storageFolder{ Windows::Storage::ApplicationData::Current().LocalFolder() };
       auto sampleFile{ co_await storageFolder.GetFileAsync(L"sample.txt") };
       Windows::Storage::Streams::IRandomAccessStream stream{ co_await sampleFile.OpenAsync(Windows::Storage::FileAccessMode::ReadWrite) };
       // The code in step 2 goes here.
   }
   

2. Selanjutnya, dapatkan aliran output dengan memanggil metode IRandomAccessStream.GetOutputStreamAt dari stream. Jika Anda menggunakan C#, maka sertakan ini dalam pernyataan penggunaan untuk mengelola masa pakai aliran output. Jika Anda menggunakan C++/WinRT, maka Anda dapat mengontrol masa pakainya dengan mengapitnya dalam blok, atau mengaturnya ke nullptr setelah Anda selesai menggunakannya.

   using (var outputStream = stream.GetOutputStreamAt(0))
   {
       // We'll add more code here in the next step.
   }
   stream.Dispose(); // Or use the stream variable (see previous code snippet) with a using statement as well.
   

   Windows::Storage::Streams::IOutputStream outputStream{ stream.GetOutputStreamAt(0) };
   // The code in step 3 goes here.
   

3. Sekarang tambahkan kode ini (jika Anda menggunakan C#, dalam pernyataan penggunaan yang ada) untuk menulis ke aliran output dengan membuat objek DataWriter baru dan memanggil metode DataWriter.WriteString .

   using (var dataWriter = new Windows.Storage.Streams.DataWriter(outputStream))
   {
       dataWriter.WriteString("DataWriter has methods to write to various types, such as DataTimeOffset.");
   }
   

   Windows::Storage::Streams::DataWriter dataWriter;
   dataWriter.WriteString(L"DataWriter has methods to write to various types, such as DataTimeOffset.");
   // The code in step 4 goes here.
   

4. Terakhir, tambahkan kode ini (jika Anda menggunakan C#, dalam pernyataan penggunaan dalam) untuk menyimpan teks ke file Anda dengan DataWriter.StoreAsync dan tutup aliran dengan IOutputStream.FlushAsync.

   await dataWriter.StoreAsync();
   await outputStream.FlushAsync();
   

   dataWriter.StoreAsync();
   outputStream.FlushAsync();
   

Praktik terbaik untuk menulis ke file

Untuk detail tambahan dan panduan praktik terbaik, lihat Praktik terbaik untuk menulis ke file.

Membaca dari file

Berikut cara membaca dari file di disk menggunakan kelas StorageFile . Langkah pertama umum untuk setiap cara membaca dari file adalah mendapatkan file dengan StorageFolder.GetFileAsync.

Windows.Storage.StorageFolder storageFolder =
    Windows.Storage.ApplicationData.Current.LocalFolder;
Windows.Storage.StorageFile sampleFile =
    await storageFolder.GetFileAsync("sample.txt");

Windows::Storage::StorageFolder storageFolder{ Windows::Storage::ApplicationData::Current().LocalFolder() };
auto sampleFile{ co_await storageFolder.GetFileAsync(L"sample.txt") };
// Process file

Membaca teks dari file

Baca teks dari file Anda dengan memanggil metode FileIO.ReadTextAsync .

string text = await Windows.Storage.FileIO.ReadTextAsync(sampleFile);

Windows::Foundation::IAsyncOperation<winrt::hstring> ExampleCoroutineAsync()
{
    Windows::Storage::StorageFolder storageFolder{ Windows::Storage::ApplicationData::Current().LocalFolder() };
    auto sampleFile{ co_await storageFolder.GetFileAsync(L"sample.txt") };
    co_return co_await Windows::Storage::FileIO::ReadTextAsync(sampleFile);
}

Membaca teks dari file dengan menggunakan buffer (2 langkah)

1. Pertama, panggil metode FileIO.ReadBufferAsync .

   var buffer = await Windows.Storage.FileIO.ReadBufferAsync(sampleFile);
   

   Windows::Storage::StorageFolder storageFolder{ Windows::Storage::ApplicationData::Current().LocalFolder() };
   auto sampleFile{ co_await storageFolder.GetFileAsync(L"sample.txt") };
   Windows::Storage::Streams::IBuffer buffer{ co_await Windows::Storage::FileIO::ReadBufferAsync(sampleFile) };
   // The code in step 2 goes here.
   

2. Kemudian gunakan objek DataReader untuk membaca terlebih dahulu panjang buffer lalu kontennya.

   using (var dataReader = Windows.Storage.Streams.DataReader.FromBuffer(buffer))
   {
       string text = dataReader.ReadString(buffer.Length);
   }
   

   auto dataReader{ Windows::Storage::Streams::DataReader::FromBuffer(buffer) };
   winrt::hstring bufferText{ dataReader.ReadString(buffer.Length()) };
   

Membaca teks dari file dengan menggunakan aliran (4 langkah)

1. Buka aliran untuk file Anda dengan memanggil metode StorageFile.OpenAsync . Ini mengembalikan aliran konten file saat operasi selesai.

   var stream = await sampleFile.OpenAsync(Windows.Storage.FileAccessMode.Read);
   

   Windows::Storage::StorageFolder storageFolder{ Windows::Storage::ApplicationData::Current().LocalFolder() };
   auto sampleFile{ co_await storageFolder.GetFileAsync(L"sample.txt") };
   Windows::Storage::Streams::IRandomAccessStream stream{ co_await sampleFile.OpenAsync(Windows::Storage::FileAccessMode::Read) };
   // The code in step 2 goes here.
   

2. Dapatkan ukuran aliran yang akan digunakan nanti.

   ulong size = stream.Size;
   

   uint64_t size{ stream.Size() };
   // The code in step 3 goes here.
   

3. Dapatkan aliran input dengan memanggil metode IRandomAccessStream.GetInputStreamAt . Masukkan ini ke dalam pernyataan penggunaan untuk mengelola masa pakai aliran. Tentukan 0 saat Anda memanggil GetInputStreamAt untuk mengatur posisi ke awal aliran.

   using (var inputStream = stream.GetInputStreamAt(0))
   {
       // We'll add more code here in the next step.
   }
   

   Windows::Storage::Streams::IInputStream inputStream{ stream.GetInputStreamAt(0) };
   Windows::Storage::Streams::DataReader dataReader{ inputStream };
   // The code in step 4 goes here.
   

4. Terakhir, tambahkan kode ini dalam pernyataan penggunaan yang ada untuk mendapatkan objek DataReader pada aliran lalu baca teks dengan memanggil DataReader.LoadAsync dan DataReader.ReadString.

   using (var dataReader = new Windows.Storage.Streams.DataReader(inputStream))
   {
       uint numBytesLoaded = await dataReader.LoadAsync((uint)size);
       string text = dataReader.ReadString(numBytesLoaded);
   }
   

   unsigned int cBytesLoaded{ co_await dataReader.LoadAsync(size) };
   winrt::hstring streamText{ dataReader.ReadString(cBytesLoaded) };
   

Baca juga

• Praktik terbaik untuk menulis ke file