Примітка: Функція, метод, об'єкт або властивість, описані в даному розділі, відключаються, якщо служба обробки виразів Microsoft Jet виконується в режимі пісочниці, який не дозволяє розраховувати потенційно небезпечні вирази. Для отримання додаткових відомостей виконайте в довідці пошук за словами "режим пісочниці".
Повертає значення типу String. визначальне ім'я файлу, каталогу або папки, яке відповідає зазначеному шаблоном, атрибуту файлу або мітці томи диска.
Функція Dir має такі аргументи:
Необов'язковий аргумент. Рядковий вираз, що визначає ім'я файлу. Може включати каталог (папку) і диск. Якщо шлях не знайдений, повертається рядок нульової довжини ( "").
Необов'язковий аргумент. Константа або числовий вираз, сума якого визначає атрибути файлу. Якщо цей аргумент опущений, функція повертає файли, відповідні шляхи. але не мають атрибутів.
Аргумент атрибути аргумент може приймати наступні значення:
Примітка: Наведені тут константи визначені в Visual Basic для додатків (VBA), що дозволяє замінювати ними числові значення в будь-якому місці програми.
У Microsoft Windows функція Dir підтримує використання символів узагальнення: зірочки (*), що замінює кілька символів, і знаку питання (?), Що заміняє один символ, з можливістю вибору декількох файлів. У macOS такі знаки сприймаються як допустимі символи імені файлу і не можуть використовуватися в якості символів узагальнення.
Так як macOS не підтримує використання символів узагальнення, для визначення групи файлів використовуйте тип файлу. Щоб замість імен файлів вказати тип файлу, скористайтеся функцією MacID. Наприклад, наступний оператор повертає ім'я першого текстового файлу в цій папці:
Щоб вивести наступний файл в папці, вкажіть порожній рядок:
При спільному використанні функцій MacID і Dir в Windows виникне помилка.
Будь-яке значення аргументу атрибути. перевищує 256, вважається значенням функції MacID.
При першому виклику функції Dir необхідно визначити аргумент шлях. інакше виникне помилка. При визначенні атрибутів файлу необхідно також вказати аргумент шлях.
Функція Dir повертає перший файл, ім'я якого відповідає значенню аргументу шлях. Щоб знайти інші файли, імена яких відповідають значенням аргументу шлях. знову викличте функцію Dir. але без аргументів. Якщо інших схожих знайдено не буде, функція Dir поверне порожній рядок ( ""). Після того як отримана порожній рядок, необхідно вказати аргумент шлях при наступних викликах функції, інакше виникне помилка. Ви можете змінити значення аргументу шлях. не чекаючи отримання всіх імен файлів, які відповідають старим значенням аргументу шлях. Однак не можна здійснити рекурсивний виклик функції Dir. За допомогою функції Dir з атрибутом vbDirectory неможливо послідовно повертати підкаталоги.
Порада. Так як імена файлів повертаються не один за одним, можна зберегти їх в масиві, а потім відсортувати його.
Примітка: У прикладах нижче показано, як використовувати цю функцію в модулі Visual Basic для додатків (VBA). Щоб отримати додаткові відомості про роботу з VBA, виберіть Довідник розробника в списку поряд з полем Пошук і введіть одне або кілька слів у поле пошуку.
У цьому прикладі функція Dir використовується для того, щоб переконатися в наявності певних файлів і каталогів. У macOS диск за замовчуванням позначається «HD:», а частини аргументу «шлях» відокремлюються один від одного двокрапкою замість зворотної косої межі. Крім того, в macOS символи узагальнення Windows сприймаються як допустимі символи імені файлу. Для вказівки групи файлів можна скористатися функцією MacID.