Информация
Запрошенная вами тема показана ниже. Однако эта тема не включена в библиотеку.

StorageFolder.CreateFileAsync(String, CreationCollisionOption) | createFileAsync(String, CreationCollisionOption) Method

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

Синтаксис


storageFolder.createFileAsync(desiredName, options).done( /* Ваши обработчики ошибок и успешных операций */ );

Параметры

desiredName

Тип: String [JavaScript] | System.String [.NET] | Platform::String [C++]

Требуемое имя создаваемого файла.

Если в текущей папке существует файл, уже имеющий указанное значение desiredName, заданное значение CreationCollisionOption определяет, как ОС Windows реагирует на конфликт.

options

Тип: CreationCollisionOption

Значение перечисления, определяющее, как Windows реагирует, если объект desiredName совпадает с именем существующего файла в текущей папке.

Возвращаемое значение

Тип: IAsyncOperation<StorageFile>

Если этот метод завершается успешно, он возвращает новый файл в виде объекта StorageFile.

Замечания

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

Примеры

Пример доступа к файлу показывает использование метода createFileAsync(String, CreationCollisionOption) для создания нового файла в библиотеке документов следующим образом:


Windows.Storage.KnownFolders.documentsLibrary.createFileAsync("sample.txt",
    Windows.Storage.CreationCollisionOption.replaceExisting).then(function (file) {
        sampleFile = file;
    });

Как показано в примере, можно использовать метод then или done для объявления функции, захватывающей и обрабатывающей новый файл. После завершения метода createFileAsync(String, CreationCollisionOption) новый файл передается в функцию обработки как объект StorageFile обработки (file в примере).

Примечание  Для создания файлов в библиотеке "Документы" необходимо объявить соответствующие возможности в манифесте приложения. Дополнительные сведения о возможностях см. в разделе Доступ к ресурсам пользователя с помощью среды выполнения Windows.

Требования

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

Windows 8

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

Windows Server 2012

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

Windows Phone 8

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

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

Метаданные

Windows.winmd

См. также

StorageFolder
CreateFileAsync(String)

 

 

Показ: