导出 (0) 打印
全部展开
信息
您所需的主题如下所示。但此主题未包含在此库中。

PathIO Class

提供使用文件的绝对路径或 URI 读取和写入文件的帮助器方法。

语法


var pathIO = Windows.Storage.PathIO;

特性

[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]

成员

PathIO类 具有以下类型的成员:

方法

The PathIO 类 具有以下方法。 使用 C#、Visual Basic 和 C++,它还可以继承以下内容中的方法 Object 类.

方法描述
AppendLinesAsync(String, IIterable(String)) Appends lines of text to the file at the specified path or Uniform Resource Identifier (URI).
AppendLinesAsync(String, IIterable(String), UnicodeEncoding) Appends lines of text to the file at the specified path or Uniform Resource Identifier (URI) using the specified character encoding.
AppendTextAsync(String, String) Appends text to the file at the specified path or Uniform Resource Identifier (URI).
AppendTextAsync(String, String, UnicodeEncoding) Appends text to the file at the specified path or Uniform Resource Identifier (URI) using the specified character encoding.
ReadBufferAsync Reads the contents of the file at the specified path or Uniform Resource Identifier (URI) and returns a buffer.
ReadLinesAsync(String) Reads the contents of the file at the specified path or Uniform Resource Identifier (URI) and returns lines of text.
ReadLinesAsync(String, UnicodeEncoding) Reads the contents of the file at the specified path or Uniform Resource Identifier (URI) using the specified character encoding and returns lines of text.
ReadTextAsync(String) Reads the contents of the file at the specified path or Uniform Resource Identifier (URI) and returns text.
ReadTextAsync(String, UnicodeEncoding) Reads the contents of the file at the specified path or Uniform Resource Identifier (URI) using the specified character encoding and returns text.
WriteBufferAsync Writes data from a buffer to the file at the specified path or Uniform Resource Identifier (URI).
WriteBytesAsync Writes a single byte of data to the file at the specified path or Uniform Resource Identifier (URI).
WriteLinesAsync(String, IIterable(String)) Writes lines of text to the file at the specified path or Uniform Resource Identifier (URI).
WriteLinesAsync(String, IIterable(String), UnicodeEncoding) Writes lines of text to the file at the specified path or Uniform Resource Identifier (URI) using the specified character encoding.
WriteTextAsync(String, String) Writes text to the file at the specified path or Uniform Resource Identifier (URI).
WriteTextAsync(String, String, UnicodeEncoding) Writes text to the file at the specified path or Uniform Resource Identifier (URI) using the specified character encoding.

 

备注

此类为静态类,不能实例化。而应该直接调用方法。

注意  若要使用路径或 URI读取或写入文件,则必须有权访问文件的位置。要了解关于您的应用程序有权访问哪些位置的详细信息,请参见 Windows 应用商店应用中的文件访问和权限

可以指定应用程序 URI 在如您的应用程序数据文件夹 ("ms-appdata://") 应用程序的特定位置读取或写入文件。若要了解有关 app URI,请参见 如何引用内容

示例

可以使用 writeTextAsync(filePathOrURI, contents) 向文件中写入文本,如下所示:



if (file !== null) {
    Windows.Storage.PathIO.writeTextAsync(filePathOrURI, "Swift as a shadow").done(function () {
        // Perform additional tasks after file is written
    },
    // Handle errors with an error function
    function (error) {
        // Handle errors encountered during write
    });
}

在此示例中,filePathOrURI 是一个局部变量,包含要读取的文件的 URI(例如应用程序 URI "ms-appdata://sampleFile.dat")或文件系统路径(例如 C:\examplepath\sampleFile.dat)。

虽然 writeTextAsync 方法没有返回值,您仍可以在文本写入文件后执行其他任务,如示例所示。

可以使用 readTextAsync(filePathOrURI) 从文件中读取文本,如下所示:


if (file !== null) {
    Windows.Storage.PathIO.readTextAsync(filePathOrURI).done(function (fileContent) {
        // Process content read from the file
    },
    // Handle errors with an error function
    function (error) {
        // Handle errors encountered during read
    });
}

在此示例中,filePathOrURI 是一个局部变量,包含要读取的文件的 URI(例如应用程序 URI "ms-appdata://sampleFile.dat")或文件系统路径(例如 C:\examplepath\sampleFile.dat)。

readTextAsync 完成后,fileContent 变量将文件的内容获取为文本字符串。然后可以根据需要处理目录。

有关更多相关示例,请参见文件访问示例FileIO

要求

最低受支持的客户端

Windows 8 [仅 Windows 应用商店应用]

最低受支持的服务器

Windows Server 2012 [仅 Windows 应用商店应用]

命名空间

Windows.Storage
Windows::Storage [C++]

元数据

Windows.winmd

另请参阅

文件访问示例
FileIO

 

 

Microsoft 正在进行一项网上调查,以了解您对 MSDN 网站的意见。 如果您选择参加,我们将会在您离开 MSDN 网站时向您显示该网上调查。

是否要参加?
显示:
© 2014 Microsoft