Udostępnij za pośrednictwem


FileSystem.Dir Metoda

Definicja

Zwraca ciąg reprezentujący nazwę pliku, katalogu lub folderu odpowiadającego określonemu wzorcowi, atrybutowi pliku lub etykietom woluminu dysku. Zapewnia FileSystem lepszą wydajność i wydajność operacji we/wy Dir plików niż funkcja. Aby uzyskać więcej informacji, zobacz GetDirectoryInfo(String).

Przeciążenia

Dir()

Zwraca ciąg reprezentujący nazwę pliku, katalogu lub folderu odpowiadającego określonemu wzorcowi, atrybutowi pliku lub etykietom woluminu dysku. Zapewnia FileSystem lepszą wydajność i wydajność operacji we/wy Dir plików niż funkcja. Aby uzyskać więcej informacji, zobacz GetDirectoryInfo(String).

Dir(String, FileAttribute)

Zwraca ciąg reprezentujący nazwę pliku, katalogu lub folderu odpowiadającego określonemu wzorcowi, atrybutowi pliku lub etykietom woluminu dysku. Zapewnia FileSystem lepszą wydajność i wydajność operacji we/wy Dir plików niż funkcja. Aby uzyskać więcej informacji, zobacz GetDirectoryInfo(String).

Dir()

Źródło:
FileSystem.vb
Źródło:
FileSystem.vb
Źródło:
FileSystem.vb

Zwraca ciąg reprezentujący nazwę pliku, katalogu lub folderu odpowiadającego określonemu wzorcowi, atrybutowi pliku lub etykietom woluminu dysku. Zapewnia FileSystem lepszą wydajność i wydajność operacji we/wy Dir plików niż funkcja. Aby uzyskać więcej informacji, zobacz GetDirectoryInfo(String).

public:
 static System::String ^ Dir();
public static string Dir ();
static member Dir : unit -> string
Public Function Dir () As String

Zwraca

Ciąg reprezentujący nazwę pliku, katalogu lub folderu odpowiadającego określonemu wzorcowi, atrybutowi pliku lub etykietom woluminu dysku.

Przykłady

W tym przykładzie użyto Dir funkcji , aby sprawdzić, czy istnieją określone pliki i katalogi.

Dim MyFile, MyPath, MyName As String
' Returns "WIN.INI" 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, including files 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.
    ' Use bitwise comparison to make sure MyName is a directory.
    If (GetAttr(MyPath & MyName) And vbDirectory) = vbDirectory Then
        ' Display entry only if it's a directory.
        MsgBox(MyName)
    End If
    MyName = Dir()   ' Get next entry.
Loop

Uwagi

Funkcja Dir obsługuje używanie symboli wieloznacznych (*) i wieloznacznych (?) w celu określenia wielu plików.

VbVolume Zwraca etykietę woluminu dla dysku zamiast określonej nazwy pliku.

Należy podać PathName po raz pierwszy wywołanie Dir funkcji. Aby pobrać następny element, możesz wykonywać kolejne wywołania Dir funkcji bez parametrów.

Ważne

Aby uruchomić poprawnie, Dir funkcja wymaga Read przyznania flag FileIOPermission i PathDiscovery do wykonywania kodu. Aby uzyskać więcej informacji, zobacz FileIOPermission, SecurityExceptioni Uprawnienia dostępu do kodu.

Wartości Attributes wyliczenia argumentów są następujące:

Wartość Stała Opis
Normal vbnormal Domyślne. Określa pliki bez atrybutów.
ReadOnly vbReadOnly Określa pliki tylko do odczytu, a także pliki bez atrybutów.
Hidden vbHidden Określa ukryte pliki, a także pliki bez atrybutów.
System vbSystem Określa pliki systemowe, a także pliki bez atrybutów.
Volume vbVolume Określa etykietę woluminu; jeśli określono jakikolwiek inny atrybut, vbVolume jest ignorowany.
Directory vbDirectory Określa katalogi lub foldery, a także pliki bez atrybutów.
Archive vbArchive Plik został zmieniony od czasu wykonania ostatniej kopii zapasowej.
Alias vbAlias Plik ma inną nazwę.

Uwaga

Te wyliczenia są określane przez język Visual Basic i mogą być używane w dowolnym miejscu w kodzie zamiast rzeczywistych wartości.

Zobacz też

Dotyczy

Dir(String, FileAttribute)

Źródło:
FileSystem.vb
Źródło:
FileSystem.vb
Źródło:
FileSystem.vb

Zwraca ciąg reprezentujący nazwę pliku, katalogu lub folderu odpowiadającego określonemu wzorcowi, atrybutowi pliku lub etykietom woluminu dysku. Zapewnia FileSystem lepszą wydajność i wydajność operacji we/wy Dir plików niż funkcja. Aby uzyskać więcej informacji, zobacz GetDirectoryInfo(String).

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static string Dir (string PathName, Microsoft.VisualBasic.FileAttribute Attributes = Microsoft.VisualBasic.FileAttribute.Normal);
public static string Dir (string PathName, Microsoft.VisualBasic.FileAttribute Attributes = Microsoft.VisualBasic.FileAttribute.Normal);
public static string Dir (string Pathname, Microsoft.VisualBasic.FileAttribute Attributes = Microsoft.VisualBasic.FileAttribute.Normal);
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Dir : string * Microsoft.VisualBasic.FileAttribute -> string
static member Dir : string * Microsoft.VisualBasic.FileAttribute -> string
Public Function Dir (PathName As String, Optional Attributes As FileAttribute = Microsoft.VisualBasic.FileAttribute.Normal) As String
Public Function Dir (Pathname As String, Optional Attributes As FileAttribute = Microsoft.VisualBasic.FileAttribute.Normal) As String

Parametry

PathNamePathname
String

Opcjonalny. Wyrażenie ciągu określające nazwę pliku, nazwę katalogu lub folderu albo etykietę woluminu dysku. Jeśli nie zostanie znaleziony, zostanie zwrócony PathName ciąg o zerowej długości ("").

Attributes
FileAttribute

Opcjonalny. Wyliczenie lub wyrażenie liczbowe, którego wartość określa atrybuty pliku. Jeśli pominięto, zwraca pliki zgodnePathname, Dir ale nie mają atrybutów.

Zwraca

Ciąg reprezentujący nazwę pliku, katalogu lub folderu odpowiadającego określonemu wzorcowi, atrybutowi pliku lub etykietom woluminu dysku.

Atrybuty

Przykłady

W tym przykładzie użyto Dir funkcji , aby sprawdzić, czy istnieją określone pliki i katalogi.

Dim MyFile, MyPath, MyName As String
' Returns "WIN.INI" 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, including files 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.
    ' Use bitwise comparison to make sure MyName is a directory.
    If (GetAttr(MyPath & MyName) And vbDirectory) = vbDirectory Then
        ' Display entry only if it's a directory.
        MsgBox(MyName)
    End If
    MyName = Dir()   ' Get next entry.
Loop

Uwagi

Funkcja Dir obsługuje używanie symboli wieloznacznych (*) i wieloznacznych (?) w celu określenia wielu plików.
VbVolume Zwraca etykietę woluminu dla dysku zamiast określonej nazwy pliku.
Należy podać PathName po raz pierwszy wywołanie Dir funkcji. Aby pobrać następny element, możesz wykonywać kolejne wywołania Dir funkcji bez parametrów.

Ważne

Aby uruchomić poprawnie, Dir funkcja wymaga Read przyznania flag FileIOPermission i PathDiscovery do wykonywania kodu. Aby uzyskać więcej informacji, zobacz FileIOPermission, SecurityExceptioni Uprawnienia dostępu do kodu.
Wartości Attributes wyliczenia argumentów są następujące:
|Wartość|Stała|Opis |
|-|-|-|
| Normal | vbnormal|Domyślny. Określa pliki, które nie mają atrybutów.|
| ReadOnly | vbReadOnly|Określa pliki tylko do odczytu, oprócz plików, które nie mają atrybutów.|
| Hidden | vbHidden|Określa ukryte pliki, oprócz plików, które nie mają atrybutów.|
| System | vbSystem|Określa pliki systemowe, oprócz plików, które nie mają atrybutów.|
| Volume | vbVolume|Określa etykietę woluminu; jeśli określono inny atrybut, vbVolume jest ignorowany.|
| Directory | vbDirectory|Określa katalogi lub foldery oprócz plików, które nie mają atrybutów.|
| Archive | vbArchive|Plik zmienił się od ostatniej kopii zapasowej.|
| Alias | vbAlias|Plik ma inną nazwę.|

Uwaga

Te wyliczenia są określane przez język Visual Basic i mogą być używane w dowolnym miejscu w kodzie zamiast rzeczywistych wartości.

Zobacz też

Dotyczy