My.Computer.FileSystem.GetDirectories-Methode

Artikel
08/20/2008

Aktualisiert: November 2007

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

' Usage
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.GetDirectories(directory)
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.GetDirectories(directory ,searchType ,wildcards)
' Declaration
Public Function GetDirectories( _
   ByVal directory As String _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)
' -or-
Public Function GetDirectories( _
   ByVal directory As String, _
   ByVal searchType As SearchOption, _
   ByVal wildcards As String() _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)

Parameter

directory
String. Name und Pfad des Verzeichnisses. Erforderlich.
searchType
SearchOption-Enumeration. Ob Unterordner einbezogen werden. Der Standardwert ist SearchOption.SearchTopLevelOnly. Erforderlich.
wildcards
String. Muster für den Namensvergleich. Erforderlich.

Rückgabewert

Schreibgeschützte Auflistung von String.

Ausnahmen

Die folgenden Bedingungen können einen Ausnahmefehler verursachen:

Der Pfad ist aus einem der folgenden Gründe ungültig: Es handelt sich um eine Zeichenfolge der Länge 0 (null), der Pfad enthält nur Leerzeichen, er enthält ungültige Zeichen, oder es handelt sich um einen Gerätepfad (beginnt mit \\.\) (ArgumentException).
Der Pfad ist ungültig, da er Nothing ist (ArgumentNullException).
Mindestens eines der angegebenen Platzhalterzeichen ist Nothing, eine leere Zeichenfolge oder enthält nur Leerzeichen (ArgumentNullException).
directory ist nicht vorhanden (DirectoryNotFoundException).
directory zeigt auf eine vorhandene Datei (IOException).
Der Pfad überschreitet die im System definierte maximale Länge (PathTooLongException).
Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format (NotSupportedException).
Der Benutzer verfügt nicht über die erforderlichen Berechtigungen zum Anzeigen des Pfads (SecurityException).
Der Benutzer verfügt nicht über die erforderlichen Berechtigungen (UnauthorizedAccessException).

Hinweise

Sie können mithilfe des wildcards-Parameters ein bestimmtes Muster angeben. Wenn Sie den Inhalt von Unterverzeichnissen in die Suche einbeziehen möchten, legen Sie den searchType-Parameter auf SearchAllSubDirectories fest.

Wenn keine Verzeichnisse gefunden werden, die mit dem angegebenen Muster übereinstimmen, wird eine leere Auflistung zurückgegeben.

Aufgaben

In der folgenden Tabelle werden Beispiele für Aufgaben mit der My.Computer.FileSystem.GetDirectories-Methode aufgeführt.

Zweck	Weitere Informationen finden Sie unter
Auflisten von Unterverzeichnissen mit einem bestimmten Muster	Gewusst wie: Suchen nach Unterverzeichnissen mit einem bestimmten Muster in Visual Basic

Beispiel

Im folgenden Beispiel werden alle Verzeichnisse in der Verzeichnisstruktur zurückgegeben, deren Name das Wort Logs enthält, und die Verzeichnisse werden ListBox1 hinzugefügt.

For Each foundDirectory As String In _
My.Computer.FileSystem.GetDirectories _
(My.Computer.FileSystem.SpecialDirectories.MyDocuments, _
True, "*Logs*")
    ListBox1.Items.Add(foundDirectory)
Next

In diesem Beispiel ist es erforderlich, dass auf dem Formular ein ListBox mit dem Namen ListBox1 vorhanden ist.

Anforderungen

Namespace:Microsoft.VisualBasic.MyServices

Klasse:FileSystemProxy (ermöglicht Zugriff auf FileSystem)

Assembly: Visual Basic-Laufzeitbibliothek (in Microsoft.VisualBasic.dll)

Verfügbarkeit nach Projekttyp

Projekttyp	Verfügbar
Windows-Anwendung	Ja
Klassenbibliothek	Ja
Konsolenanwendung	Ja
Windows-Steuerelementbibliothek	Ja
Web-Steuerelementbibliothek	Ja
Windows-Dienst	Ja
Website	Ja

Berechtigungen

Die folgende Berechtigung ist möglicherweise erforderlich:

Berechtigung	Beschreibung
FileIOPermission	Steuert die Fähigkeit, auf Dateien und Ordner zuzugreifen. Zugeordnete Enumeration: Unrestricted.

Weitere Informationen finden Sie unter Codezugriffssicherheit und unter Anfordern von Berechtigungen.

Siehe auch

Referenz

My.Computer.FileSystem-Objekt

SearchOption-Enumeration

System.Collections.ObjectModel.ReadOnlyCollection<T>

FileSystem.GetDirectories

Freigeben über