FileIO Class

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

Синтаксис


var fileIO = Windows.Storage.FileIO;

Атрибуты

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

Члены

FileIOКласс содержит члены следующих типов:

Методы

The FileIO Класс содержит следующие методы. При использовании C#, Visual Basic и C++ также наследует методы от Object Класс.

МетодОписание
AppendLinesAsync(IStorageFile, IIterable(String)) Appends lines of text to the specified file.
AppendLinesAsync(IStorageFile, IIterable(String), UnicodeEncoding) Appends lines of text to the specified file using the specified character encoding.
AppendTextAsync(IStorageFile, String) Appends text to the specified file.
AppendTextAsync(IStorageFile, String, UnicodeEncoding) Appends text to the specified file using the specified character encoding.
ReadBufferAsync Reads the contents of the specified file and returns a buffer.
ReadLinesAsync(IStorageFile) Reads the contents of the specified file and returns lines of text.
ReadLinesAsync(IStorageFile, UnicodeEncoding) Reads the contents of the specified file using the specified character encoding and returns lines of text.
ReadTextAsync(IStorageFile) Reads the contents of the specified file and returns text.
ReadTextAsync(IStorageFile, UnicodeEncoding) Reads the contents of the specified file using the specified character encoding and returns text.
WriteBufferAsync Writes data from a buffer to the specified file.
WriteBytesAsync Writes an array of bytes of data to the specified file.
WriteLinesAsync(IStorageFile, IIterable(String)) Writes lines of text to the specified file.
WriteLinesAsync(IStorageFile, IIterable(String), UnicodeEncoding) Writes lines of text to the specified file using the specified character encoding.
WriteTextAsync(IStorageFile, String) Writes text to the specified file.
WriteTextAsync(IStorageFile, String, UnicodeEncoding) Writes text to the specified file using the specified character encoding.

 

Замечания

Этот класс является статическим; создавать его экземпляры нельзя. Вместо этого вызывайте методы напрямую.

Дополнительные сведения о том, обращаться к каким файлам и расположениям может приложение, см. в разделе о доступе к файлам и разрешения в приложениях Магазина Windows.

Сведения о том, как выполнять чтение из файлов и запись в файлы, см. в разделе Краткое руководство. Чтение и запись файла.

Примеры

Пример доступа к файлу показывает использование writeTextAsync(file, contents) для записи текста в файл.



if (file !== null) {
    Windows.Storage.FileIO.writeTextAsync(file, "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
    });
}

В этом примере тип file является локальной переменной, содержащей класс storageFile, представляющий файл для записи.

Хотя методы writeTextAsync не имеют возвращаемого значения, по-прежнему можно выполнить дополнительные задачи после записи текста в файл, как показано в примере.

Пример доступа к файлу также показывает способ использования readTextAsync(file) для считывания текста из файла.


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

В этом примере тип file является локальной переменной, содержащей класс storageFile, представляющий файл для чтения.

После завершения readTextAsync, переменная fileContent получает содержимое файла в виде текстовой строки. Затем можно требуемым образом обработать содержимое.

Требования

Минимальная версия клиента

Windows 8 [Только приложения Магазина Windows]

Минимальная версия сервера

Windows Server 2012 [Только приложения Магазина Windows]

Пространство имен

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

Метаданные

Windows.winmd

 

 

Показ:
© 2014 Microsoft