FileIO Класс

Определение

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

Windows.Storage

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

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Требования к 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)	Записывает текст в указанный файл с использованием указанной кодировки символов.