Глобальный контекст.НайтиФайлыАсинх (Global context.FindFilesAsync)
Глобальный контекст (Global context)
НайтиФайлыАсинх (FindFilesAsync)
Доступен, начиная с версии 8.3.18.
Синтаксис:
НайтиФайлыАсинх(<Путь>, <Маска>, <ИскатьВПодкаталогах>)Параметры:
<Путь> (обязательный)
Путь к каталогу, в котором производится поиск. Каталог может быть как на локальной сети, так и на ftp-сервере. При использовании этой схемы в адресах необходимо указывать прямые слеши '/', а не обратные '\'.
Допускается указание полного имени файла (путь + имя).
<Маска> (необязательный)
Маска выбора файлов.
Если параметр задан, то первый параметр воспринимается системой как путь к каталогу, в котором требуется найти файлы, удовлетворяющие маске выбора.
Для операционной системы MS Windows:
В строке маски, помимо обычных символов, допускается использование символа "*" (звездочка), обозначающего любое число произвольных символов, и "?" (знак вопроса), обозначающего один произвольный символ.
Примеры строки:
| "отчет201?.docx", "*.pdf". |
Для операционных систем Linux, macOS, iOS и Android:
В строке маски допускается использование следующих последовательностей:
- любой символ, допустимый в имени файла. Сопоставление указанных символов производится:
- для Linux, macOS - с учетом регистра,
- для iOS и Android - без учета регистра;
- "*" (звездочка) - любая последовательность символов;
- "?" (знак вопроса) - любой символ;
- "[" - класс символов. После открывающей квадратной скобки указывается последовательность символов. Шаблон соответствует любому из указанных символов. Можно указывать диапазон, используя "-". Описание класса символов завершается "]". Для указания "-" в качестве символа класса нужно указать его первым или последним символом. Если после "[" указан знак "!", то класс описывает все символы, кроме указанных.
| "Все файлы|*.*|Документы|???.docx;*.[Rr][Tt][Ff];doc[0-9].txt". |
<ИскатьВПодкаталогах> (необязательный)
Истина - будет произведен обход вложенных в параметр <Путь> каталогов и поиск в них.
Параметр игнорируется, если не задан параметр <Маска>, т.к. предполагается, что ищется один файл.
Значение по умолчанию: Ложь.
Возвращаемое значение:
Тип: Обещание.Результат выполнения обещания - массив объектов типа Файл, одержащий найденные файлы.
Описание:
Асинхронная функция. Выполняет поиск по заданной маске файлов и каталогов, расположенных в заданном каталоге.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.
Примечание:
Все искомые объекты должны находиться в одном каталоге.Для работы метода на веб-клиенте необходимо предварительно подключить расширение работы с файлами.
См. также:
Глобальный контекст, метод НачатьПоискФайловГлобальный контекст, метод НайтиФайлы
Использование в версии:
Доступен, начиная с версии 8.3.18.