FileSystemProxy.GetFiles Methode

Definition

Namespace:

Microsoft.VisualBasic.MyServices

Assembly:

Microsoft.VisualBasic.Forms.dll

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

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; es 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 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

• SearchOption
• ReadOnlyCollection<T>
• Objekte (Visual Basic)
• Gewusst wie: Suchen nach Dateien mit einem bestimmten Muster in Visual Basic
• Gewusst wie: Abrufen einer Auflistung der Dateien in einem Verzeichnis in Visual Basic

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

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; es 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 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

• ReadOnlyCollection<T>
• Objekte (Visual Basic)
• Gewusst wie: Suchen nach Dateien mit einem bestimmten Muster in Visual Basic
• Gewusst wie: Abrufen einer Auflistung der Dateien in einem Verzeichnis in Visual Basic