FileSystem.GetFiles Methode

Definition

Namespace:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.Core.dll

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

Überlädt

GetFiles(String)	Gibt eine schreibgeschützte Auflistung von Zeichenfolgen zurück, die die Namen der Dateien in einem Verzeichnis darstellen.
GetFiles(String, SearchOption, String[])	Gibt eine schreibgeschützte Auflistung von Zeichenfolgen zurück, die die Namen der Dateien in einem Verzeichnis darstellen.

GetFiles(String)

Quelle:

FileSystem.vb

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

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory);

public static System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory);

static member GetFiles : string -> System.Collections.ObjectModel.ReadOnlyCollection<string>

Public Shared Function GetFiles (directory As String) As ReadOnlyCollection(Of String)

Parameter

directory

String

Das zu durchsuchende Verzeichnis.

Gibt zurück

ReadOnlyCollection<String>

Eine schreibgeschützte Auflistung von Dateinamen aus dem angegebenen Verzeichnis.

Ausnahmen

ArgumentException

Der Pfad ist aus einem der folgenden Gründe ungültig: Er ist eine Zeichenfolge der Länge null; es enthält nur Leerzeichen; enthält ungültige Zeichen; oder es ist ein Gerätepfad (beginnt mit \\.\).

ArgumentNullException

directory ist Nothing.

DirectoryNotFoundException

Das zu durchsuchende Verzeichnis ist nicht vorhanden.

IOException

directory zeigt auf eine vorhandene Datei.

PathTooLongException

Der Pfad überschreitet die im System definierte maximale Länge.

NotSupportedException

Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format.

SecurityException

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

UnauthorizedAccessException

Der Benutzer verfügt nicht über die erforderlichen Berechtigungen.

Beispiele

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

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

Für dieses Beispiel ist es erforderlich, dass Sie auf Ihrem Formular über einen ListBox Benannten verfügen ListBox1 .

In diesem Beispiel werden alle Dateien im Verzeichnis mit der Erweiterung .txt zurückgegeben und zu ListBox1hinzugefü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

Für dieses Beispiel ist es erforderlich, dass Sie auf Ihrem Formular über einen ListBox Benannten verfügen ListBox1 .

Hinweise

Es wird eine leere Sammlung zurückgegeben, wenn keine Dateien dem angegebenen Muster entsprechen.

In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt, die die My.Computer.FileSystem.GetFiles -Methode betreffen.

Beschreibung	Siehe
Abrufen der Sammlung von Dateien in einem Verzeichnis	Gewusst wie: Abrufen einer Auflistung der Dateien in einem Verzeichnis in Visual Basic
Suchen nach Dateien mit einem bestimmten Muster in einem Verzeichnis	Gewusst wie: Suchen nach Dateien mit einem bestimmten Muster in Visual Basic

Weitere Informationen

• ReadOnlyCollection<T>

GetFiles(String, SearchOption, String[])

Quelle:

FileSystem.vb

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

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory, Microsoft::VisualBasic::FileIO::SearchOption searchType, ... cli::array <System::String ^> ^ wildcards);

public static System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] wildcards);

static member GetFiles : string * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>

Public Shared Function GetFiles (directory As String, searchType As SearchOption, ParamArray wildcards As String()) As ReadOnlyCollection(Of String)

Parameter

directory

String

Das zu durchsuchende Verzeichnis.

searchType

SearchOption

Gibt an, ob Unterordner eingeschlossen werden. Der Standardwert ist SearchOption.SearchTopLevelOnly.

wildcards

String[]

Das Muster, das übereinstimmen muss.

Gibt zurück

ReadOnlyCollection<String>

Eine schreibgeschützte Auflistung von Dateinamen aus dem angegebenen Verzeichnis.

Ausnahmen

ArgumentException

Der Pfad ist aus einem der folgenden Gründe ungültig: Er ist eine Zeichenfolge der Länge null; es enthält nur Leerzeichen; enthält ungültige Zeichen; oder es ist ein Gerätepfad (beginnt mit \\.\).

ArgumentNullException

directory ist Nothing.

DirectoryNotFoundException

Das zu durchsuchende Verzeichnis ist nicht vorhanden.

IOException

directory zeigt auf eine vorhandene Datei.

PathTooLongException

Der Pfad überschreitet die im System definierte maximale Länge.

NotSupportedException

Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format.

SecurityException

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

UnauthorizedAccessException

Der Benutzer verfügt nicht über die erforderlichen Berechtigungen.

Beispiele

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

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

Für dieses Beispiel ist es erforderlich, dass Sie auf Ihrem Formular über einen ListBox Benannten verfügen ListBox1 .

In diesem Beispiel werden alle Dateien im Verzeichnis mit der Erweiterung .txt zurückgegeben und zu ListBox1hinzugefü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

Für dieses Beispiel ist es erforderlich, dass Sie auf Ihrem Formular über einen ListBox Benannten verfügen ListBox1 .

Hinweise

Es wird eine leere Sammlung zurückgegeben, wenn keine Dateien dem angegebenen Muster entsprechen.

In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt, die die My.Computer.FileSystem.GetFiles -Methode betreffen.

Beschreibung	Siehe
Abrufen der Sammlung von Dateien in einem Verzeichnis	Gewusst wie: Abrufen einer Auflistung der Dateien in einem Verzeichnis in Visual Basic
Suchen nach Dateien mit einem bestimmten Muster in einem Verzeichnis	Gewusst wie: Suchen nach Dateien mit einem bestimmten Muster in Visual Basic

Weitere Informationen

• SearchOption
• ReadOnlyCollection<T>