FileSystem.Dir Metoda

Definicja

Przestrzeń nazw:: Microsoft.VisualBasic

Zestaw:: Microsoft.VisualBasic.Core.dll

Zestaw:: Microsoft.VisualBasic.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zwraca ciąg reprezentujący nazwę pliku, katalogu lub folderu zgodnego z określonym wzorcem lub atrybutem pliku albo etykietą woluminu dysku. Zapewnia FileSystem lepszą wydajność i wydajność operacji we/wy plików niż Dir funkcja. Aby uzyskać więcej informacji, zobacz GetDirectoryInfo(String).

Przeciążenia

Nazwa	Opis
Dir()	Zwraca ciąg reprezentujący nazwę pliku, katalogu lub folderu zgodnego z określonym wzorcem lub atrybutem pliku albo etykietą woluminu dysku. Zapewnia FileSystem lepszą wydajność i wydajność operacji we/wy plików niż `Dir` funkcja. Aby uzyskać więcej informacji, zobacz GetDirectoryInfo(String).
Dir(String, FileAttribute)	Zwraca ciąg reprezentujący nazwę pliku, katalogu lub folderu zgodnego z określonym wzorcem lub atrybutem pliku albo etykietą woluminu dysku. Zapewnia FileSystem lepszą wydajność i wydajność operacji we/wy plików niż `Dir` 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

Źródło:: FileSystem.vb

Źródło:: FileSystem.vb

public:
 static System::String ^ Dir();

public static string Dir();

static member Dir : unit -> string

Public Function Dir () As String

Zwraca

String

Ciąg reprezentujący nazwę pliku, katalogu lub folderu zgodnego z określonym wzorcem lub atrybutem pliku albo etykietą 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żna

Wartości Attributes wyliczenia argumentu są następujące:

Wartość	Stała	Opis
`Normal`	`vbnormal`	Wartość domyślna. 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 zmienił się od ostatniej kopii zapasowej.
`Alias`	`vbAlias`	Plik ma inną nazwę.

Note

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

Źródło:: FileSystem.vb

Źródło:: FileSystem.vb

[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

Optional. 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 "" ciąg o zerowej długości (PathName).

Attributes: FileAttribute

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