Funkcja Dir

Ważne : Ten artykuł został przetłumaczony maszynowo, zobacz zastrzeżenie. Angielskojęzyczną wersję tego artykułu można znaleźć tutaj .

Uwaga : Funkcja, metody, obiektu lub właściwości opisane w tym temacie jest wyłączona, jeśli usługa wyrażeń programu Microsoft Jet działa w trybie piaskownicy, co uniemożliwia oceny potencjalnie niebezpieczne wyrażenia. Aby uzyskać więcej informacji na temat trybu piaskownicy wyszukaj ciąg "tryb piaskownicy" w Pomocy.

Zwraca ciąg reprezentujący nazwę pliku, katalogu lub folderu, który pasuje do określonego wzorca lub atrybut pliku lub etykieta dysku.

Składnia

Dir [(ścieżki [atrybuty] )]

W składni funkcji Dir występują następujące argumenty:

Argument

Opis

Nazwa ścieżki

Opcjonalnie. Ciąg wyrażenie określające nazwę pliku — może zawierać katalog lub folder, a dysk. Ciąg o zerowej długości ("") jest zwracana, jeśli nie zostanie znaleziony ścieżki .

atrybuty

Opcjonalnie. Stała lub wyrażenie numeryczne, którego suma określa atrybuty pliku. Pominięcie zwraca plików zgodne ścieżki , które mają żadnych atrybutów.


Ustawienia

Ustawieniaargumentatrybutysą następujące:

Stała

Wartość

Opis

vbNormal

0

(Ustawienie domyślne) Określa pliki bez atrybutów.

vbReadOnly

1

Określa pliki tylko do odczytu, oprócz plików bez atrybutów.

vbHidden

2

Określa pliki ukryte, oprócz plików bez atrybutów.

VbSystem

4

Określa pliki systemowe, oprócz plików bez atrybutów. Nie jest dostępna na komputerze Macintosh.

vbVolume

8

Określa etykietę woluminu; Jeśli określono jakikolwiek inny, vbVolume jest ignorowana. Nie jest dostępna na komputerze Macintosh.

vbDirectory

16

Określa katalogi lub foldery, oprócz plików bez atrybutów.

vbAlias

64

Nazwa pliku jest alias. Dostępne tylko na komputerze Macintosh.


Uwaga : Te stałe są określane w języku Visual Basic for Applications (VBA), może być używana w dowolnym miejscu kodu zamiast rzeczywistych wartości.

Spostrzeżenia

W systemie Microsoft Windows Dir obsługuje wiele znaków (*) i symboli wieloznacznych pojedynczy znak (?) w celu określenia wielu plików. Na komputerze Macintosh tych znaków są traktowane jako prawidłowe znaki nazw plików i nie można użyć jako symboli wieloznacznych w celu określenia wielu plików.

Ponieważ systemu Macintosh nie obsługuje symboli wieloznacznych, używanie typu pliku do identyfikowania grupy plików. Funkcja MacID Aby określić typ pliku, a nie przy użyciu nazw plików. Na przykład następująca instrukcja zwraca nazwę pierwszej plik TEKSTOWY w bieżącym folderze:

Dir("SomePath", MacID("TEXT"))

Aby przejść przez wszystkie pliki w folderze, należy określić pusty ciąg:

Dir("")

Jeśli funkcja MacID z Dir w systemie Windows, wystąpi błąd.

Każda wartość atrybuty większa niż 256 jest traktowany jako wartość MacID .

Konieczne jest określenie po raz pierwszy Wywołaj Dir lub wystąpi błąd. Jeśli użytkownik określi również atrybuty, ścieżka musi być dołączone.

Dir zwraca pierwszą nazwę pliku, która jest zgodna z nazwą ścieżki. Aby uzyskać następne nazwy plików zgodne ścieżki, zadzwoń Dir ponownie bez argumentów. Gdy nie więcej pasujących nazw plików, Dir zwraca ciąg o zerowej długości (""). Gdy zostanie zwrócony ciąg o zerowej długości, konieczne jest określenie w kolejnych zaproszeń lub wystąpi błąd. Możesz zmienić na nowe ścieżki bez pobranie wszystkich nazw plików, które są zgodne z bieżącej ścieżki. Nie można jednak wywołać lokalizacji funkcja Dir . Wywoływanie Dirrekurencyjnie ciągłe zwraca podkatalogów.

Porada     Ponieważ nazwy plików są pobierane w losowej kolejności, można przechowywać nazwy plików zwracanych w tablica, a następnie posortować tablicy.

Przykład

Uwaga : Poniższe przykłady przedstawiają sposób użycia tej funkcji w module języka Visual Basic for Applications (VBA). Aby uzyskać dodatkowe informacje na temat pracy w języku VBA, wybierz pozycję Dokumentacja dewelopera z listy rozwijanej obok przycisku Wyszukaj i wprowadź odpowiednie terminy w polu wyszukiwania.

W tym przykładzie użyto funkcji Dir , aby sprawdzić, jeśli istnieją określone pliki i katalogi. Na komputerze Macintosh "HD:" jest domyślna nazwa dysku i części ścieżki są oddzielone przecinkami, a nie ukośników odwrotnych. Ponadto wieloznaczne systemu Windows są traktowane jako prawidłowe znaki w nazwie pliku na komputerze Macintosh. Jednak służy funkcja MacID można określać grupy plików.

Dim MyFile, MyPath, MyName
' Returns "WIN.INI" (on Microsoft Windows) if it exists.
MyFile = Dir("C:\WINDOWS\WIN.INI")
' Returns filename with specified extension. If more than one *.ini
' file exists, the first file found is returned.
MyFile = Dir("C:\WINDOWS\*.INI")
' Call Dir again without arguments to return the next *.INI file in the
' same directory.
MyFile = Dir
' Return first *.TXT file with a set hidden attribute.
MyFile = Dir("*.TXT", vbHidden)
' Display the names in C:\ that represent directories.
MyPath = "c:\" ' Set the path.
MyName = Dir(MyPath, vbDirectory) ' Retrieve the first entry.
Do While MyName <> "" ' Start the loop.
' Ignore the current directory and the encompassing directory.
If MyName <> "." And MyName <> ".." Then
' Use bitwise comparison to make sure MyName is a directory.
If (GetAttr(MyPath & MyName) And vbDirectory) = vbDirectory Then
Debug.Print MyName ' Display entry only if it
End If ' it represents a directory.
End If
MyName = Dir ' Get next entry.
Loop

Uwaga : Zrzeczenie dotyczące tłumaczenia maszynowego: Ten artykuł został przetłumaczony przez system komputerowy bez interwencji człowieka. Firma Microsoft udostępnia te tłumaczenia maszynowe, aby ułatwić użytkownikom, którzy nie znają języka angielskiego, korzystanie z zawartości dotyczącej produktów, usług i technologii firmy Microsoft. Ponieważ ten artykuł został przetłumaczony maszynowo, może zawierać błędy w słownictwie, składniowe lub gramatyczne.

Rozwijaj swoje umiejętności
Poznaj szkolenia
Uzyskuj nowe funkcje w pierwszej kolejności
Dołącz do niejawnych testerów pakietu Office

Czy te informacje były pomocne?

Dziękujemy za opinię!

Dziękujemy za opinię! Wygląda na to, że połączenie Cię z jednym z naszych agentów pomocy technicznej pakietu Office może być pomocne.

×