FileIO 類別

定義

命名空間:

Windows.Storage

提供協助程式方法來讀取和寫入 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

繼承

Object Platform::Object IInspectable FileIO

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

範例

檔案 存取範例 示範如何使用 WriteTextAsync (檔案、內容) 將文字寫入檔案。

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
    }
}

在此範例中， file 是區域變數，其中包含代表要寫入之檔案的 StorageFile 。

雖然 WriteTextAsync 方法沒有傳回值，但您仍然可以在將文字寫入檔案之後執行其他工作，如範例所示。檔案 存取範例 也會示範如何使用 ReadTextAsync (檔案) 從檔案讀取文字。

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
    }
}

在此範例中， file 是區域變數，其中包含代表要讀取之檔案的 StorageFile 。

ReadTextAsync完成之後， fileContent 變數會以文字字串的形式取得檔案的內容。 然後，您可以視需要處理內容。

備註

這個類別是靜態的，無法具現化。 請改為直接呼叫 方法。

若要深入瞭解您的應用程式可以存取的位置，請參閱 檔案存取權限。

若要瞭解如何讀取和寫入檔案，請參閱 建立、寫入和讀取檔案。

方法

AppendLinesAsync(IStorageFile, IIterable<String>)	將文字行附加至指定的檔案。
AppendLinesAsync(IStorageFile, IIterable<String>, UnicodeEncoding)	使用指定的字元編碼，將文字行附加至指定的檔案。
AppendTextAsync(IStorageFile, String)	將文字附加至指定的檔案。
AppendTextAsync(IStorageFile, String, UnicodeEncoding)	使用指定的字元編碼，將文字附加至指定的檔案。
ReadBufferAsync(IStorageFile)	讀取指定檔案的內容，並傳回緩衝區。
ReadLinesAsync(IStorageFile)	讀取指定檔案的內容，並傳回文字行。
ReadLinesAsync(IStorageFile, UnicodeEncoding)	使用指定的字元編碼讀取指定檔案的內容，並傳回文字行。
ReadTextAsync(IStorageFile)	讀取指定檔案的內容並傳回文字。
ReadTextAsync(IStorageFile, UnicodeEncoding)	使用指定的字元編碼讀取指定檔案的內容，並傳回文字。
WriteBufferAsync(IStorageFile, IBuffer)	將資料從緩衝區寫入指定的檔案。
WriteBytesAsync(IStorageFile, Byte[])	將資料位元組陣列寫入指定的檔案。
WriteLinesAsync(IStorageFile, IIterable<String>)	將文字行寫入指定的檔案。
WriteLinesAsync(IStorageFile, IIterable<String>, UnicodeEncoding)	使用指定的字元編碼，將文字行寫入指定的檔案。
WriteTextAsync(IStorageFile, String)	將文字寫入指定的檔案。
WriteTextAsync(IStorageFile, String, UnicodeEncoding)	使用指定的字元編碼，將文字寫入指定的檔案。