FileSystem.GetDirectories Methode

Definition

Namespace:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.Core.dll

Gibt eine Auflistung von Zeichenfolgen zurück, die die Pfadnamen der Unterverzeichnisse in einem Verzeichnis darstellen.

Überlädt

GetDirectories(String)	Gibt eine Auflistung von Zeichenfolgen zurück, die die Pfadnamen der Unterverzeichnisse in einem Verzeichnis darstellen.
GetDirectories(String, SearchOption, String[])	Gibt eine Auflistung von Zeichenfolgen zurück, die die Pfadnamen der Unterverzeichnisse in einem Verzeichnis darstellen.

GetDirectories(String)

Quelle:

FileSystem.vb

Gibt eine Auflistung von Zeichenfolgen zurück, die die Pfadnamen der Unterverzeichnisse in einem Verzeichnis darstellen.

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

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

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

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

Parameter

directory

String

Name und Pfad des Verzeichnisses.

Gibt zurück

ReadOnlyCollection<String>

Schreibgeschützte Auflistung der Pfadnamen für die Unterverzeichnisse im 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

Der directory ist Nothing oder eine leere Zeichenfolge.

DirectoryNotFoundException

Das angegebene Verzeichnis ist nicht vorhanden.

IOException

Das angegebene Verzeichnis 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 Verzeichnisse in der Verzeichnisstruktur zurückgegeben, die das Wort Logs in ihren Namen enthalten, und fügt sie hinzu ListBox1.

For Each foundDirectory In My.Computer.FileSystem.GetDirectories(
      My.Computer.FileSystem.SpecialDirectories.MyDocuments,
      True, "*Logs*")

    ListBox1.Items.Add(foundDirectory)
Next

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

Hinweise

In der folgenden Tabelle ist ein Beispiel für eine Aufgabe aufgeführt, die die My.Computer.FileSystem.GetDirectories -Methode umfasst.

Beschreibung	Siehe
Auflisten von Unterverzeichnissen mit einem bestimmten Muster	Gewusst wie: Suchen nach Unterverzeichnissen mit einem bestimmten Muster in Visual Basic

Weitere Informationen

• SearchOption
• ReadOnlyCollection<T>

GetDirectories(String, SearchOption, String[])

Quelle:

FileSystem.vb

Gibt eine Auflistung von Zeichenfolgen zurück, die die Pfadnamen der Unterverzeichnisse in einem Verzeichnis darstellen.

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

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

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

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

Parameter

directory

String

Name und Pfad des Verzeichnisses.

searchType

SearchOption

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

wildcards

String[]

Das Muster für den Namensvergleich.

Gibt zurück

ReadOnlyCollection<String>

Schreibgeschützte Auflistung der Pfadnamen für die Unterverzeichnisse im 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

Mindestens eines der angegebenen Platzhalterzeichen ist Nothing, eine leere Zeichenfolge oder enthält nur Leerzeichen.

DirectoryNotFoundException

Das angegebene Verzeichnis ist nicht vorhanden.

IOException

Das angegebene Verzeichnis 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 Verzeichnisse in der Verzeichnisstruktur zurückgegeben, die das Wort Logs in ihren Namen enthalten, und fügt sie hinzu ListBox1.

For Each foundDirectory In My.Computer.FileSystem.GetDirectories(
      My.Computer.FileSystem.SpecialDirectories.MyDocuments,
      True, "*Logs*")

    ListBox1.Items.Add(foundDirectory)
Next

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

Hinweise

Sie können den wildcards -Parameter verwenden, um ein bestimmtes Muster anzugeben. Wenn Sie den Inhalt der Unterverzeichnisse in Ihre Suche mit einbeziehen möchten, legen Sie den searchType-Parameter auf SearchAllSubDirectories fest.

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

In der folgenden Tabelle ist ein Beispiel für eine Aufgabe aufgeführt, die die My.Computer.FileSystem.GetDirectories -Methode umfasst.

Beschreibung	Siehe
Auflisten von Unterverzeichnissen mit einem bestimmten Muster	Gewusst wie: Suchen nach Unterverzeichnissen mit einem bestimmten Muster in Visual Basic

Weitere Informationen

• SearchOption
• ReadOnlyCollection<T>