Freigeben über


FileSystem.GetFiles Methode

Definition

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
Quelle:
FileSystem.vb
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

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

Ausnahmen

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 \\.\).

directory ist Nothing.

Das zu durchsuchende Verzeichnis ist nicht vorhanden.

directory zeigt auf eine vorhandene Datei.

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

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

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

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

Gilt für:

GetFiles(String, SearchOption, String[])

Quelle:
FileSystem.vb
Quelle:
FileSystem.vb
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

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

Ausnahmen

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 \\.\).

directory ist Nothing.

Das zu durchsuchende Verzeichnis ist nicht vorhanden.

directory zeigt auf eine vorhandene Datei.

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

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

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

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

Gilt für: