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(file, contents) を使用してファイルにテキストを書き込む方法を示します。

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

この例では、 は、 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)	指定した文字エンコードを使用して、指定したファイルにテキストを書き込みます。