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)	使用指定的字符编码将文本写入指定文件。