FileIO Класс

Определение

Предоставляет вспомогательные методы для чтения и записи файлов, представленных объектами типа 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
Атрибуты

Требования к Windows

Семейство устройств
Windows 10 (появилось в 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v1.0)

Примеры

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

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(file) для чтения текста из файла.

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 , представляющий считываемые файлы.

После завершения fileContentreadTextAsync переменная получает содержимое файла в виде текстовой строки. Затем можно обработать содержимое соответствующим образом.

Комментарии

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

Дополнительные сведения о том, к каким расположениям может получить приложение, см. в разделе Разрешения на доступ к файлам.

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

Методы

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)

Записывает текст в указанный файл с использованием указанной кодировки символов.

Применяется к