Teilen über


FileSystemProxy.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, SearchOption, String[])

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

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.

public:
 System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory, Microsoft::VisualBasic::FileIO::SearchOption searchType, ... cli::array <System::String ^> ^ wildcards);
public System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] wildcards);
member this.GetFiles : string * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>
Public 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; es 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 Ihr Formular über einen ListBox Benannten verfügt 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 Ihr Formular über einen ListBox Benannten verfügt 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 Vorgehensweise: Abrufen einer Sammlung der Dateien in einem Verzeichnis
Suchen von Dateien mit einem bestimmten Muster in einem Verzeichnis Vorgehensweise: Suchen nach Dateien mit einem bestimmten Muster

Weitere Informationen

Gilt für:

GetFiles(String)

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

public:
 System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory);
public System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory);
member this.GetFiles : string -> System.Collections.ObjectModel.ReadOnlyCollection<string>
Public 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; es 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 Ihr Formular über einen ListBox Benannten verfügt 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 Ihr Formular über einen ListBox Benannten verfügt 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 Vorgehensweise: Abrufen einer Sammlung der Dateien in einem Verzeichnis
Suchen von Dateien mit einem bestimmten Muster in einem Verzeichnis Vorgehensweise: Suchen nach Dateien mit einem bestimmten Muster

Weitere Informationen

Gilt für: