FileSystem.Dir Methode

Definition

Namespace:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Gibt eine Zeichenfolge zurück, die den Namen einer Datei, eines Verzeichnisses oder eines Ordners darstellt, die einem angegebenen Muster oder Dateiattribute oder der Volumebezeichnung eines Laufwerks entspricht. Dadurch FileSystem erhalten Sie eine bessere Produktivität und Leistung in Datei-E/A-Vorgängen als die Dir Funktion. Weitere Informationen finden Sie unter GetDirectoryInfo(String).

Überlädt

Name	Beschreibung
Dir()	Gibt eine Zeichenfolge zurück, die den Namen einer Datei, eines Verzeichnisses oder eines Ordners darstellt, die einem angegebenen Muster oder Dateiattribute oder der Volumebezeichnung eines Laufwerks entspricht. Dadurch FileSystem erhalten Sie eine bessere Produktivität und Leistung in Datei-E/A-Vorgängen als die `Dir` Funktion. Weitere Informationen finden Sie unter GetDirectoryInfo(String).
Dir(String, FileAttribute)	Gibt eine Zeichenfolge zurück, die den Namen einer Datei, eines Verzeichnisses oder eines Ordners darstellt, die einem angegebenen Muster oder Dateiattribute oder der Volumebezeichnung eines Laufwerks entspricht. Dadurch FileSystem erhalten Sie eine bessere Produktivität und Leistung in Datei-E/A-Vorgängen als die `Dir` Funktion. Weitere Informationen finden Sie unter GetDirectoryInfo(String).

Dir()

Quelle:: FileSystem.vb

Quelle:: FileSystem.vb

Quelle:: FileSystem.vb

Quelle:: FileSystem.vb

Quelle:: FileSystem.vb

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

public static string Dir();

static member Dir : unit -> string

Public Function Dir () As String

Gibt zurück

String

Eine Zeichenfolge, die den Namen einer Datei, eines Verzeichnisses oder eines Ordners darstellt, die einem angegebenen Muster oder Dateiattribute oder der Volumebezeichnung eines Laufwerks entspricht.

Beispiele

In diesem Beispiel wird die Dir Funktion verwendet, um zu überprüfen, ob bestimmte Dateien und Verzeichnisse vorhanden sind.

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

Hinweise

Die Dir Funktion unterstützt die Verwendung von Mehrfachzeichen (*) und einstelligen (?) Wildcards zum Angeben mehrerer Dateien.

VbVolume gibt die Volumebezeichnung für das Laufwerk anstelle eines bestimmten Dateinamens zurück.

Sie müssen das PathName erste Mal angeben, dass Sie die Dir Funktion aufrufen. Um das nächste Element abzurufen, können Sie nachfolgende Aufrufe an die Dir Funktion ohne Parameter ausführen.

Important

Die Attributes Argumentenumerationswerte sind wie folgt:

Wert	Dauerhaft	Description
`Normal`	`vbnormal`	Standard. Gibt Dateien ohne Attribute an.
`ReadOnly`	`vbReadOnly`	Gibt schreibgeschützte Dateien und auch Dateien ohne Attribute an.
`Hidden`	`vbHidden`	Gibt ausgeblendete Dateien und auch Dateien ohne Attribute an.
`System`	`vbSystem`	Gibt Systemdateien und auch Dateien ohne Attribute an.
`Volume`	`vbVolume`	Gibt die Volumebezeichnung an; wenn ein anderes Attribut angegeben wird, `vbVolume` wird ignoriert.
`Directory`	`vbDirectory`	Gibt Verzeichnisse oder Ordner sowie Dateien ohne Attribute an.
`Archive`	`vbArchive`	Datei wurde seit der letzten Sicherung geändert.
`Alias`	`vbAlias`	Die Datei hat einen anderen Namen.

Note

Diese Enumerationen werden von der Visual Basic Sprache angegeben und können an einer beliebigen Stelle im Code anstelle der tatsächlichen Werte verwendet werden.

Weitere Informationen

Gilt für:

Dir(String, FileAttribute)

Quelle:: FileSystem.vb

Quelle:: FileSystem.vb

Quelle:: FileSystem.vb

Quelle:: FileSystem.vb

Quelle:: 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

Parameter

PathNamePathname: String

Dies ist optional. Ein Zeichenfolgenausdruck, der einen Dateinamen, einen Verzeichnis- oder Ordnernamen oder eine Laufwerkvolumebezeichnung angibt. Eine leere Zeichenfolge ("") wird zurückgegeben, wenn PathName sie nicht gefunden wird.

Attributes: FileAttribute

Dies ist optional. Aufzählung oder numerischer Ausdruck, deren Wert Dateiattribute angibt. Wenn nicht angegeben, werden Dateien zurückgegeben, die übereinstimmenDir, Pathname aber keine Attribute aufweisen.

Gibt zurück

String

Attribute: SupportedOSPlatformAttribute

Beispiele

In diesem Beispiel wird die Dir Funktion verwendet, um zu überprüfen, ob bestimmte Dateien und Verzeichnisse vorhanden sind.

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

Hinweise

Die Dir Funktion unterstützt die Verwendung von Mehrfachzeichen (*) und einstelligen (?) Wildcards zum Angeben mehrerer Dateien. VbVolume gibt die Volumebezeichnung für das Laufwerk anstelle eines bestimmten Dateinamens zurück. Sie müssen das PathName erste Mal angeben, dass Sie die Dir Funktion aufrufen. Um das nächste Element abzurufen, können Sie nachfolgende Aufrufe an die Dir Funktion ohne Parameter ausführen.

Important

Note

Diese Enumerationen werden durch die Visual Basic Sprache angegeben und können an einer beliebigen Stelle im Code anstelle der tatsächlichen Werte verwendet werden.

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?