PathIO Класс

Определение

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

Windows.Storage

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

public ref class PathIO 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 PathIO 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 PathIO

Public Class PathIO

Наследование

Object Platform::Object IInspectable PathIO

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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

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

Примеры

Для записи текста в файл можно использовать WriteTextAsync(filePathOrURI, contents). В этом примере является локальной переменной, содержащей URI приложения (например, filePathOrURI URI приложения "ms-appdata://sampleFile.dat") или путь к файловой системе (например, C:\examplepath\sampleFile.dat) для считываемого файла. Хотя методы WriteTextAsync не имеют возвращаемого значения, вы по-прежнему можете выполнять дополнительные задачи после записи текста в файл, как показано в примере.

try
{
    if (file != null)
    {
        await PathIO.WriteTextAsync(filePathOrURI, "Swift as a shadow");
    }
}
// Handle errors with catch blocks
catch (FileNotFoundException)
{
    // For example, handle file not found
}

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

try
{
    if (file != null)
    {
        string fileContent = await PathIO.ReadTextAsync(filePathOrURI);
    }
}
// Handle errors with catch blocks
catch (FileNotFoundException)
{
    // For example, handle file not found
}

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

Комментарии

Для чтения или записи в файл с помощью пути или универсального кода ресурса (URI) необходимо иметь разрешение на доступ к расположению файла. Дополнительные сведения о расположениях, к каким расположениям у вашего приложения есть разрешение на доступ, см. в разделе Разрешения на доступ к файлам.

Вы можете указать универсальный код ресурса (URI) приложения для чтения или записи файлов в расположениях конкретного приложения, таких как папка данных приложения ("ms-appdata://"). Дополнительные сведения о универсальном коде ресурса (URI) приложения см. в статье Ссылка на содержимое.

Методы

AppendLinesAsync(String, IIterable<String>)	Добавляет строки текста в файл по указанному пути или универсальному коду ресурса (URI).
AppendLinesAsync(String, IIterable<String>, UnicodeEncoding)	Добавляет строки текста в файл по указанному пути или универсальному коду ресурса (URI), используя указанную кодировку символов.
AppendTextAsync(String, String)	Добавляет текст в файл по указанному пути или универсальному коду ресурса (URI).
AppendTextAsync(String, String, UnicodeEncoding)	Добавляет текст в файл по указанному пути или универсальному коду ресурса (URI), используя указанную кодировку символов.
ReadBufferAsync(String)	Считывает содержимое файла по указанному пути или универсальному коду ресурса (URI) и возвращает буфер.
ReadLinesAsync(String)	Считывает содержимое файла по указанному пути или универсальному коду ресурса (URI) и возвращает строки текста.
ReadLinesAsync(String, UnicodeEncoding)	Считывает содержимое файла по указанному пути или универсальному коду ресурса (URI) с использованием указанной кодировки символов и возвращает строки текста.
ReadTextAsync(String)	Считывает содержимое файла по указанному пути или универсальному коду ресурса (URI) и возвращает текст.
ReadTextAsync(String, UnicodeEncoding)	Считывает содержимое файла по указанному пути или универсальному коду ресурса (URI), используя указанную кодировку символов, и возвращает текст.
WriteBufferAsync(String, IBuffer)	Записывает данные из буфера в файл по указанному пути или универсальному коду ресурса (URI).
WriteBytesAsync(String, Byte[])	Записывает один байт данных в файл по указанному пути или универсальному коду ресурса (URI).
WriteLinesAsync(String, IIterable<String>)	Записывает строки текста в файл по указанному пути или по универсальному коду ресурса (URI).
WriteLinesAsync(String, IIterable<String>, UnicodeEncoding)	Записывает строки текста в файл по указанному пути или универсальному коду ресурса (URI), используя указанную кодировку символов.
WriteTextAsync(String, String)	Записывает текст в файл по указанному пути или универсальному коду ресурса (URI).
WriteTextAsync(String, String, UnicodeEncoding)	Записывает текст в файл по указанному пути или универсальному коду ресурса (URI), используя указанную кодировку символов.

См. также раздел

• FileIO
• Пример доступа к файлам