Notă: Funcția, metoda, obiectul sau proprietatea descrise în această secțiune sunt dezactivate dacă serviciul de procesare a expresiilor Microsoft Jet rulează în modul Sandbox, ceea ce nu permite calcularea unor expresii potențial nesigure. Pentru mai multe informații, căutați ajutorul pentru cuvântul "modul sandbox" din ajutor.
Returnează o valoare de tip String. Specifică numele unui fișier, director sau folder care se potrivește cu șablonul specificat, atributul de fișier sau eticheta volumului discului.
Funcția Dir are următoarele argumente:
Argument opțional. O expresie de șir care specifică numele fișierului. Poate include un director (folder) și un disc. Dacă nu se găsește nici o cale, se întoarce un șir de lungime zero ("").
Argument opțional. O expresie constantă sau numerică a cărei sumă determină atributele unui fișier. Dacă acest argument este omis, funcția returnează fișierele corespunzătoare căii. dar fără atribute.
Argumentul atributelor Argument poate lua următoarele valori:
Notă: Constantele afișate aici sunt definite în Visual Basic for Applications (VBA), care vă permite să le înlocuiți cu valori numerice oriunde în program.
În Microsoft Windows, funcția Dir acceptă utilizarea caracterelor de tip wildcard: un asterisc (*) care înlocuiește mai multe caractere și un semn de întrebare (?) Care înlocuiește un caracter pentru a specifica mai multe fișiere. În macOS, aceste caractere sunt tratate ca caractere valide în numele fișierului și nu pot fi folosite ca metacaractere.
Deoarece MacOS nu acceptă utilizarea de caractere cu metacaractere, utilizați tipul fișierului pentru a defini un grup de fișiere. Pentru a specifica tipul de fișier în locul denumirilor de fișiere, utilizați funcția MacID. De exemplu, următoarea declarație returnează numele primului fișier text din dosarul curent:
Pentru a afișa următorul fișier într-un dosar, specificați un șir gol:
Dacă utilizați funcțiile MacID și Dir în Windows, apare o eroare.
Orice valoare a atributelor argumentului. 256 este considerată valoarea funcției MacID.
Când apelați pentru prima dată funcția Dir, trebuie să definiți argumentul căii. în caz contrar, va apărea o eroare. La definirea atributelor de fișier, trebuie să specificați și argumentul căii.
Funcția Dir returnează primul fișier al cărui nume corespunde valorii căii de argument. Pentru a găsi alte fișiere ale căror nume corespund valorii căii de argument. apelați din nou funcția Dir. dar fără argumente. Dacă nu se găsesc alte potriviri, funcția Dir returnează un șir gol (""). După primirea unui șir gol, trebuie să specificați argumentul căii pentru apelurile de funcții ulterioare, în caz contrar apare o eroare. Puteți modifica valoarea căii de argument. Nu așteptați toate numele de fișiere care se potrivesc cu valoarea veche a căii de argument. Totuși, nu puteți apela recursiv funcția Dir. Folosind funcția Dir cu atributul vbDirectory, nu este posibilă returnarea subdirectoarelor succesive.
Consiliul. Deoarece numele fișierelor nu sunt returnate în ordine, le puteți salva într-o matrice și apoi sortați-le.
Notă: Exemplele de mai jos arată modul de utilizare a acestei funcții în modulul Visual Basic for Applications (VBA). Pentru mai multe informații despre lucrul cu VBA, selectați referința dezvoltatorului din lista derulantă de lângă câmpul Căutare și introduceți unul sau mai multe cuvinte în câmpul de căutare.
În acest exemplu, funcția Dir este utilizată pentru a se asigura că anumite fișiere și directoare sunt prezente. În MacOS, unitatea implicită este "HD:", iar părțile din argumentul "path" sunt separate unul de celălalt prin intermediul colonilor în locul backslash-urilor. În plus, în MacOS, caracterele wildcard ale Windows sunt tratate ca caractere valide pentru nume de fișiere. Puteți utiliza funcția MacID pentru a specifica un grup de fișiere.