PathIO Class

Предоставляет вспомогательные методы для чтения и записи файла с использованием абсолютного пути к файлу.

Синтаксис


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://"). Дополнительные сведения об универсальных кодах ресурса (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

 

 

Показ:
© 2014 Microsoft