FileSystem.GetFiles Methode
Definition
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 schreibgeschützte Auflistung von Zeichenfolgen zurück, die die Namen von Dateien in einem Verzeichnis darstellen.
Überlädt
| Name | Beschreibung |
|---|---|
| GetFiles(String) |
Gibt eine schreibgeschützte Auflistung von Zeichenfolgen zurück, die die Namen von Dateien in einem Verzeichnis darstellen. |
| GetFiles(String, SearchOption, String[]) |
Gibt eine schreibgeschützte Auflistung von Zeichenfolgen zurück, die die Namen von Dateien in einem Verzeichnis darstellen. |
GetFiles(String)
Gibt eine schreibgeschützte Auflistung von Zeichenfolgen zurück, die die Namen von 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
Verzeichnis, das durchsucht werden soll.
Gibt zurück
Schreibgeschützte Auflistung von Dateinamen aus dem angegebenen Verzeichnis.
Ausnahmen
Der Pfad ist aus einem der folgenden Gründe ungültig: Es handelt sich um eine leere Zeichenfolge; es enthält nur Leerzeichen; enthält ungültige Zeichen; oder es handelt sich um einen Gerätepfad (beginnt mit \\.\).
directory ist Nothing.
Das zu durchsuchende Verzeichnis ist nicht vorhanden.
directory verweist auf eine vorhandene Datei.
Der Pfad überschreitet die vom System definierte maximale Länge.
Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder weist ein ungültiges Format auf.
Der Benutzer verfügt nicht über erforderliche Berechtigungen zum Anzeigen des Pfads.
Der Benutzer verfügt nicht über erforderliche Berechtigungen.
Beispiele
Das folgende Beispiel gibt alle Dateien im Verzeichnis zurück und fügt sie hinzu ListBox1.
For Each foundFile In My.Computer.FileSystem.GetFiles(
My.Computer.FileSystem.SpecialDirectories.MyDocuments)
ListBox1.Items.Add(foundFile)
Next
In diesem Beispiel ist es erforderlich, dass Sie einen ListBox Namen ListBox1 in Ihrem Formular haben.
In diesem Beispiel werden alle Dateien im Verzeichnis mit der Erweiterung .txt zurückgegeben und dieser hinzugefügt ListBox1.
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 Sie einen ListBox Namen ListBox1 in Ihrem Formular haben.
Hinweise
Eine leere Auflistung wird zurückgegeben, wenn keine Dateien gefunden werden, die dem angegebenen Muster entsprechen.
In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt, die die My.Computer.FileSystem.GetFiles Methode betreffen.
| To | Siehe |
|---|---|
| Abrufen der Sammlung von Dateien in einem Verzeichnis | How to: Get the collection of Files in a Directory in Visual Basic |
| Suchen von Dateien mit einem bestimmten Muster in einem Verzeichnis | How to: Find Files with a Specific Pattern in Visual Basic |
Weitere Informationen
Gilt für:
GetFiles(String, SearchOption, String[])
Gibt eine schreibgeschützte Auflistung von Zeichenfolgen zurück, die die Namen von 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
Verzeichnis, das durchsucht werden soll.
- searchType
- SearchOption
Gibt an, ob Unterordner eingeschlossen werden sollen. Der Standardwert ist SearchOption.SearchTopLevelOnly.
- wildcards
- String[]
Muster, das abgeglichen werden soll.
Gibt zurück
Schreibgeschützte Auflistung von Dateinamen aus dem angegebenen Verzeichnis.
Ausnahmen
Der Pfad ist aus einem der folgenden Gründe ungültig: Es handelt sich um eine leere Zeichenfolge; es enthält nur Leerzeichen; enthält ungültige Zeichen; oder es handelt sich um einen Gerätepfad (beginnt mit \\.\).
directory ist Nothing.
Das zu durchsuchende Verzeichnis ist nicht vorhanden.
directory verweist auf eine vorhandene Datei.
Der Pfad überschreitet die vom System definierte maximale Länge.
Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder weist ein ungültiges Format auf.
Der Benutzer verfügt nicht über erforderliche Berechtigungen zum Anzeigen des Pfads.
Der Benutzer verfügt nicht über erforderliche Berechtigungen.
Beispiele
Das folgende Beispiel gibt alle Dateien im Verzeichnis zurück und fügt sie hinzu ListBox1.
For Each foundFile In My.Computer.FileSystem.GetFiles(
My.Computer.FileSystem.SpecialDirectories.MyDocuments)
ListBox1.Items.Add(foundFile)
Next
In diesem Beispiel ist es erforderlich, dass Sie einen ListBox Namen ListBox1 in Ihrem Formular haben.
In diesem Beispiel werden alle Dateien im Verzeichnis mit der Erweiterung .txt zurückgegeben und dieser hinzugefügt ListBox1.
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 Sie einen ListBox Namen ListBox1 in Ihrem Formular haben.
Hinweise
Eine leere Auflistung wird zurückgegeben, wenn keine Dateien gefunden werden, die dem angegebenen Muster entsprechen.
In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt, die die My.Computer.FileSystem.GetFiles Methode betreffen.
| To | Siehe |
|---|---|
| Abrufen der Sammlung von Dateien in einem Verzeichnis | How to: Get the collection of Files in a Directory in Visual Basic |
| Suchen von Dateien mit einem bestimmten Muster in einem Verzeichnis | How to: Find Files with a Specific Pattern in Visual Basic |