My.Computer.FileSystem.GetFiles-Methode

Artikel
08/20/2008

Aktualisiert: November 2007

Gibt eine schreibgeschützte Auflistung von Zeichenfolgen zurück, die die Namen der Dateien in einem Verzeichnis darstellen.

' Usage
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.GetFiles(directory)
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.GetFiles(directory ,searchType ,wildcards)
' Declaration
Public Function GetFiles( _
   ByVal directory As String _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)
' -or-
Public Function GetFiles( _
   ByVal directory As String, _
   ByVal searchType As SearchOption, _
   ByVal wildcards As String() _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)

Parameter

directory
String. Das zu durchsuchende Verzeichnis. Erforderlich.
searchType
SearchOption-Enumeration. Ob Unterordner einbezogen werden. Der Standardwert ist SearchOption.SearchTopLevelOnly. Erforderlich.
wildcards
String. Das zu vergleichende Muster. Erforderlich.

Rückgabewert

Schreibgeschützte Auflistung von Zeichenfolgen.

Ausnahmen

Die folgenden Bedingungen können eine Ausnahme verursachen:

Der Pfad ist aus einem der folgenden Gründe ungültig: Es handelt sich um eine Zeichenfolge der Länge 0 (null), der Pfad enthält nur Leerzeichen, er enthält ungültige Zeichen, oder es handelt sich um einen Gerätepfad (beginnt mit \\.\) (ArgumentException).
Der Pfad ist ungültig, da er Nothing ist (ArgumentNullException).
directory ist nicht vorhanden (DirectoryNotFoundException).
directory zeigt auf eine vorhandene Datei (IOException).
Der Pfad überschreitet die im System definierte maximale Länge (PathTooLongException).
Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format (NotSupportedException).
Der Benutzer verfügt nicht über die erforderlichen Berechtigungen zum Anzeigen des Pfads (SecurityException).
Der Benutzer verfügt nicht über die erforderlichen Berechtigungen (UnauthorizedAccessException).

Hinweise

Wenn keine Dateien gefunden werden, die mit dem angegebenen Muster übereinstimmen, wird eine leere Auflistung zurückgegeben.

Aufgaben

In der folgenden Tabelle werden Beispiele für Aufgaben mit der My.Computer.FileSystem.GetFiles-Methode aufgeführt.

Zweck	Weitere Informationen finden Sie unter
Abrufen der Auflistung der Dateien in einem Verzeichnis	Gewusst wie: Abrufen einer Auflistung der Dateien in einem Verzeichnis in Visual Basic
Suchen von Dateien mit einem bestimmten Muster in einem Verzeichnis	Gewusst wie: Suchen nach Dateien mit einem bestimmten Muster in Visual Basic

Beispiel

Im folgenden Beispiel werden alle Dateien im Verzeichnis zurückgegeben und ListBox1 hinzugefügt.

For Each foundFile As String In My.Computer.FileSystem.GetFiles _
(My.Computer.FileSystem.SpecialDirectories.MyDocuments)
    ListBox1.Items.Add(foundFile)
Next

In diesem Beispiel ist es erforderlich, dass auf dem Formular ein ListBox mit dem Namen ListBox1 vorhanden ist.

In diesem Beispiel werden alle Dateien im Verzeichnis mit der Erweiterung .dll zurückgegeben und ListBox1 hinzugefügt.

For Each foundFile As String In My.Computer.FileSystem.GetFiles _
      (My.Computer.FileSystem.SpecialDirectories.MyDocuments, _
       FileIO.SearchOption.SearchTopLevelOnly, "*.txt")
    ListBox1.Items.Add(foundFile)
Next

In diesem Beispiel ist es erforderlich, dass auf dem Formular ein ListBox mit dem Namen ListBox1 vorhanden ist.