FileIO Kelas

Definisi

Ruang nama:

Windows.Storage

Menyediakan metode pembantu untuk membaca dan menulis file yang diwakili oleh objek jenis IStorageFile.

public ref class FileIO abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class FileIO final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class FileIO

Public Class FileIO

Warisan

Object Platform::Object IInspectable FileIO

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Contoh

Sampel Akses File memperlihatkan kepada Anda cara menggunakan WriteTextAsync(file, konten) untuk menulis teks ke file.

try
{
    if (file != null)
    {
        await FileIO.WriteTextAsync(file, "Swift as a shadow");
    }
}
catch (FileNotFoundException)
{
    // For example, handle file not found
}

try
{
    if (file)
    {
        co_await FileIO::WriteTextAsync(file, L"Swift as a shadow");
    }
}
catch (hresult_error const& ex)
{
    if (ex.code() == HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND))
    {
        // For example, handle file not found
    }
}

Dalam contoh, file adalah variabel lokal yang berisi StorageFile yang mewakili file untuk ditulis.

Meskipun metode WriteTextAsync tidak memiliki nilai yang dikembalikan, Anda masih dapat melakukan tugas tambahan setelah teks ditulis ke file, seperti yang ditunjukkan contoh. Sampel Akses File juga memperlihatkan kepada Anda cara menggunakan ReadTextAsync(file) untuk membaca teks dari file.

try
{
    if (file != null)
    {
        string fileContent = await FileIO.ReadTextAsync(file);
    }
}
catch (FileNotFoundException)
{
    // For example, handle file not found
}

try
{
    if (file)
    {
        hstring fileContent = co_await FileIO::ReadTextAsync(file);
    }
}
catch (hresult_error const& ex)
{
    if (ex.code() == HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND))
    {
        // For example, handle file not found
    }
}

Dalam contoh, file adalah variabel lokal yang berisi StorageFile yang mewakili file untuk dibaca.

Setelah ReadTextAsync selesai, fileContent variabel mendapatkan konten file sebagai string teks. Anda kemudian dapat memproses konten yang sesuai.

Keterangan

Kelas ini statis dan tidak dapat diinstansiasi. Panggil metode secara langsung sebagai gantinya.

Untuk mempelajari selengkapnya tentang lokasi apa yang dapat diakses aplikasi Anda, lihat Izin akses file.

Untuk mempelajari cara membaca dan menulis ke file, lihat Membuat, menulis, dan membaca file.

Metode

AppendLinesAsync(IStorageFile, IIterable<String>)	Menambahkan baris teks ke file yang ditentukan.
AppendLinesAsync(IStorageFile, IIterable<String>, UnicodeEncoding)	Menambahkan baris teks ke file yang ditentukan menggunakan pengodean karakter yang ditentukan.
AppendTextAsync(IStorageFile, String)	Menambahkan teks ke file yang ditentukan.
AppendTextAsync(IStorageFile, String, UnicodeEncoding)	Menambahkan teks ke file yang ditentukan menggunakan pengodean karakter yang ditentukan.
ReadBufferAsync(IStorageFile)	Membaca konten file yang ditentukan dan mengembalikan buffer.
ReadLinesAsync(IStorageFile)	Membaca konten file yang ditentukan dan mengembalikan baris teks.
ReadLinesAsync(IStorageFile, UnicodeEncoding)	Membaca konten file yang ditentukan menggunakan pengodean karakter yang ditentukan dan mengembalikan baris teks.
ReadTextAsync(IStorageFile)	Membaca konten file yang ditentukan dan mengembalikan teks.
ReadTextAsync(IStorageFile, UnicodeEncoding)	Membaca konten file yang ditentukan menggunakan pengodean karakter yang ditentukan dan mengembalikan teks.
WriteBufferAsync(IStorageFile, IBuffer)	Menulis data dari buffer ke file yang ditentukan.
WriteBytesAsync(IStorageFile, Byte[])	Menulis array byte data ke file yang ditentukan.
WriteLinesAsync(IStorageFile, IIterable<String>)	Menulis baris teks ke file yang ditentukan.
WriteLinesAsync(IStorageFile, IIterable<String>, UnicodeEncoding)	Menulis baris teks ke file yang ditentukan menggunakan pengodean karakter yang ditentukan.
WriteTextAsync(IStorageFile, String)	Menulis teks ke file yang ditentukan.
WriteTextAsync(IStorageFile, String, UnicodeEncoding)	Menulis teks ke file yang ditentukan menggunakan pengodean karakter yang ditentukan.