PathIO 类

定义

命名空间:

Windows.Storage

提供帮助程序方法，用于使用文件的绝对路径或统一资源标识符 (URI) 读取和写入文件。

public ref class PathIO 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 PathIO 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 PathIO

Public Class PathIO

继承

Object Platform::Object IInspectable PathIO

属性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

示例

可以使用 WriteTextAsync (filePathOrURI、内容) 将文本写入文件。 在示例中， 是一个局部变量， filePathOrURI 其中包含一个 URI (，例如应用 URI“ms-appdata：//sampleFile.dat”) 或文件系统路径 (C：\examplepath\sampleFile.dat) 供文件读取。 尽管 WriteTextAsync 方法没有返回值，但在将文本写入文件后，仍可以执行其他任务，如示例所示。

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

可以使用 ReadTextAsync (filePathOrURI) 从文件读取文本。 ReadTextAsync 完成后，fileContent变量将文件内容作为文本字符串获取。 然后，可以根据需要处理内容。

try
{
    if (file != null)
    {
        string fileContent = await PathIO.ReadTextAsync(filePathOrURI);
    }
}
// Handle errors with catch blocks
catch (FileNotFoundException)
{
    // For example, handle file not found
}

有关更多相关示例，请参阅 文件访问示例 和 FileIO。

注解

若要使用路径或统一资源标识符 (URI) 读取或写入文件，必须有权访问文件的位置。 若要详细了解应用有权访问的位置，请参阅 文件访问权限。

可以指定应用统一资源标识符 (URI) ，以在应用数据文件夹 (“ms-appdata：//”) 等应用特定位置读取或写入文件。 若要详细了解应用统一资源标识符 (URI) ，请参阅 如何引用内容。

方法

AppendLinesAsync(String, IIterable<String>)	将文本行追加到文件指定的路径或统一资源标识符 (URI) 。
AppendLinesAsync(String, IIterable<String>, UnicodeEncoding)	使用指定的字符编码将文本行追加到指定路径或统一资源标识符 (URI) 的文件。
AppendTextAsync(String, String)	将文本追加到文件指定路径或统一资源标识符 (URI) 。
AppendTextAsync(String, String, UnicodeEncoding)	使用指定的字符编码将文本追加到指定路径或统一资源标识符 (URI) 的文件。
ReadBufferAsync(String)	读取指定路径或统一资源标识符处的文件内容， (URI) 并返回缓冲区。
ReadLinesAsync(String)	读取指定路径或统一资源标识符处的文件内容， (URI) 并返回文本行。
ReadLinesAsync(String, UnicodeEncoding)	使用指定的字符编码读取指定路径或统一资源标识符 (URI) 的文件内容，并返回文本行。
ReadTextAsync(String)	读取指定路径或统一资源标识符处的文件内容， (URI) 并返回文本。
ReadTextAsync(String, UnicodeEncoding)	使用指定的字符编码) 读取指定路径或统一资源标识符 (URI 处的文件内容，并返回文本。
WriteBufferAsync(String, IBuffer)	将数据从缓冲区写入指定路径或统一资源标识符 (URI) 的文件。
WriteBytesAsync(String, Byte[])	将单个字节的数据写入指定路径或统一资源标识符 (URI) 的文件。
WriteLinesAsync(String, IIterable<String>)	将文本行写入文件指定路径或统一资源标识符 (URI) 。
WriteLinesAsync(String, IIterable<String>, UnicodeEncoding)	使用指定的字符编码将文本行写入指定路径或统一资源标识符 (URI) 的文件。
WriteTextAsync(String, String)	将文本写入指定路径或统一资源标识符 (URI) 的文件。
WriteTextAsync(String, String, UnicodeEncoding)	使用指定的字符编码将文本写入指定路径或统一资源标识符 (URI) 的文件。

另请参阅

• FileIO
• 文件访问示例