PathIO Класс

Определение

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

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

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

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