25 882 документа
← К списку

Глобальный контекст.УдалитьФайлыАсинх (Global context.DeleteFilesAsync)

страница

Глобальный контекст (Global context)

УдалитьФайлыАсинх (DeleteFilesAsync)

Доступен, начиная с версии 8.3.18.

Синтаксис:

УдалитьФайлыАсинх(<Путь>, <Маска>)

Параметры:

<Путь> (обязательный)

Тип: Строка.
Путь к удаляемым файлам.

<Маска> (необязательный)

Тип: Строка.
Маска для выбора удаляемых файлов.
Если <Маска> не указана, то удаляются все файлы и каталог <Путь>.
Для операционной системы MS Windows:
В строке маски, помимо обычных символов, допускается использование символа "*" (звездочка), обозначающего любое число произвольных символов, и "?" (знак вопроса), обозначающего один произвольный символ.
Для операционных систем Linux, macOS:
В строке маски допускается использование следующих последовательностей:

  • любой символ, допустимый в имени файла. Сопоставление указанных символов производится с учетом регистра;
  • "*" (звездочка) - любая последовательность символов;
  • "?" (знак вопроса) - любой символ;
  • "[" - класс символов. После открывающей квадратной скобки указывается последовательность символов. Паттерн соответствует любому из указанных символов. Можно указывать диапазон, используя "-". Описание класса символов завершается "]". Для указания "-" в качестве символа класса нужно указать его первым или последним символом. Если после "[" указан знак "!", то класс описывает все символы, кроме указанных.

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

Тип: Обещание.
Результат выполнения обещания - Неопределено.

Описание:

Асинхронная функция. Удаляет указанные файлы.

Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, толстый клиент, мобильное приложение (клиент).

Примечание:

Для удаления одного файла можно передать его полное имя через первый параметр либо передать путь к нему через первый параметр, а его короткое имя - через второй.
Удаление файлов производится, если в указанных файлах не установлено свойство "Только чтение". В противном случае генерируется сообщение об ошибке.
Допускается использование схем http, https и ftp для адресации файлов. При использовании этих схем в адресах необходимо указывать прямые слеши '/', а не обратные '\'.
Для работы метода на веб-клиенте необходимо предварительно подключить расширение работы с файлами.
На веб-клиенте метод работает только с локальными файлами.

См. также:

Глобальный контекст, метод НачатьУдалениеФайлов
Глобальный контекст, метод УдалитьФайлы

Использование в версии:

Доступен, начиная с версии 8.3.18.


     Методическая информация