Freigeben über

FileSystem.Dir Methode

  • Referenz

Definition

Namespace:
Microsoft.VisualBasic
Assembly:
Microsoft.VisualBasic.Core.dll
Assembly:
Microsoft.VisualBasic.dll

Gibt eine Zeichenfolge zurück, die den Namen einer Datei, eines Verzeichnisses oder eines Ordners darstellt, der einem bestimmten Muster oder Dateiattribut oder der Volumebezeichnung eines Laufwerks entspricht. Das FileSystem ermöglicht bei Datei-E/A-Vorgängen höhere Produktivität und Leistung als die Dir-Funktion. Weitere Informationen finden Sie unter GetDirectoryInfo(String).

Überlädt

Dir()

Gibt eine Zeichenfolge zurück, die den Namen einer Datei, eines Verzeichnisses oder eines Ordners darstellt, der einem bestimmten Muster oder Dateiattribut oder der Volumebezeichnung eines Laufwerks entspricht. Das FileSystem ermöglicht bei Datei-E/A-Vorgängen höhere Produktivität und Leistung 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, der einem bestimmten Muster oder Dateiattribut oder der Volumebezeichnung eines Laufwerks entspricht. Das FileSystem ermöglicht bei Datei-E/A-Vorgängen höhere Produktivität und Leistung als die Dir-Funktion. Weitere Informationen finden Sie unter GetDirectoryInfo(String).

Dir()

Quelle:
FileSystem.vb
Quelle:
FileSystem.vb
Quelle:
FileSystem.vb

Gibt eine Zeichenfolge zurück, die den Namen einer Datei, eines Verzeichnisses oder eines Ordners darstellt, der einem bestimmten Muster oder Dateiattribut oder der Volumebezeichnung eines Laufwerks entspricht. Das FileSystem ermöglicht bei Datei-E/A-Vorgängen höhere Produktivität und Leistung als die Dir-Funktion. Weitere Informationen finden Sie unter GetDirectoryInfo(String).

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, der einem bestimmten Muster oder Dateiattribut 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 Feldhaltern mit mehreren Zeichen (*) und einstelligen Zeichen (?), um mehrere Dateien anzugeben.

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

Sie müssen eine PathName angeben, wenn Sie die Dir Funktion zum ersten Mal aufrufen. Um das nächste Element abzurufen, können Sie nachfolgende Aufrufe der Dir Funktion ohne Parameter ausführen.

Wichtig

Damit die Dir Funktion ordnungsgemäß ausgeführt werden kann, müssen dem ausführenden Code die Read Flags und PathDiscovery von FileIOPermission gewährt werden. Weitere Informationen finden Sie unter FileIOPermission, SecurityExceptionund Codezugriffsberechtigungen.

Die Attributes Argumentaufzählungswerte sind wie folgt:

Wert Konstante Beschreibung
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 Die Datei wurde nach der letzten Sicherung geändert.
Alias vbAlias Die Datei hat einen anderen Namen.

Hinweis

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

Gibt eine Zeichenfolge zurück, die den Namen einer Datei, eines Verzeichnisses oder eines Ordners darstellt, der einem bestimmten Muster oder Dateiattribut oder der Volumebezeichnung eines Laufwerks entspricht. Das FileSystem ermöglicht bei Datei-E/A-Vorgängen höhere Produktivität und Leistung als die Dir-Funktion. Weitere Informationen finden Sie unter 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

Parameter

PathNamePathname
String

Dies ist optional. Ein Zeichenfolgenausdruck, der einen Dateinamen, ein Verzeichnis, einen Ordnernamen oder eine Volumebezeichnung des Laufwerks angibt. Eine Zeichenfolge der Länge 0 (null) ("") wird zurückgegeben, wenn PathName nicht gefunden wird.

Attributes
FileAttribute

Dies ist optional. Enumeration oder numerischer Ausdruck, dessen Wert Dateiattribute angibt. Wenn der Wert nicht angegeben wird, gibt Dir Dateien zurück, die mit Pathname übereinstimmen, aber keine Attribute besitzen.

Gibt zurück

String

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

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 Feldhaltern mit mehreren Zeichen (*) und einstelligen Zeichen (?), um mehrere Dateien anzugeben.
VbVolume gibt die Volumebezeichnung für das Laufwerk anstelle eines bestimmten Dateinamens zurück.
Sie müssen eine PathName angeben, wenn Sie die Dir Funktion zum ersten Mal aufrufen. Um das nächste Element abzurufen, können Sie nachfolgende Aufrufe der Dir Funktion ohne Parameter ausführen.

Wichtig

Damit die Dir Funktion ordnungsgemäß ausgeführt werden kann, müssen dem ausführenden Code die Read Flags und PathDiscovery von FileIOPermission gewährt werden. Weitere Informationen finden Sie unter FileIOPermission, SecurityExceptionund Codezugriffsberechtigungen.
Die Attributes Argumentaufzählungswerte sind wie folgt:
|Wert|Konstante|Beschreibung|
|-|-|-|
| Normal | vbnormal|Standard. Gibt Dateien ohne Attribute an.|
| ReadOnly | vbReadOnly|Gibt schreibgeschützte Dateien an, zusätzlich zu Dateien ohne Attribute.|
| Hidden | vbHidden|Gibt ausgeblendete Dateien an, zusätzlich zu Dateien ohne Attribute.|
| System | vbSystem|Gibt Systemdateien an, zusätzlich zu Dateien ohne Attribute.|
| Volume | vbVolume|Gibt die Volumebezeichnung an; wenn ein anderes Attribut angegeben wird, vbVolume wird ignoriert.|
| Directory | vbDirectory|Gibt Verzeichnisse oder Ordner zusätzlich zu Dateien an, die keine Attribute enthalten.|
| Archive | vbArchive|Die Datei wurde seit der letzten Sicherung geändert.|
| Alias | vbAlias|Die Datei hat einen anderen Namen.|

Hinweis

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

Weitere Informationen

Gilt für: