Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

DirectoryInfo.GetDirectories-Methode: (String, SearchOption)

 

Veröffentlicht: Oktober 2016

Gibt ein Array von Verzeichnissen im aktuellen DirectoryInfo zurück, die den angegebenen Suchkriterien entsprechen. Anhand eines Werts wird bestimmt, ob in Unterverzeichnissen gesucht wird.

Namespace:   System.IO
Assembly:  mscorlib (in mscorlib.dll)

public DirectoryInfo[] GetDirectories(
	string searchPattern,
	SearchOption searchOption
)

Parameter

searchPattern
Type: System.String

Die Suchzeichenfolge für die Überprüfung der Namen von Verzeichnissen auf Übereinstimmungen. Dieser Parameter kann eine Kombination aus gültigem Literalpfad und Platzhalterzeichen (* und ?) enthalten (siehe Hinweise), unterstützt jedoch keine regulären Ausdrücke. Das Standardmuster ist "*", wobei alle Dateien zurückgegeben werden.

searchOption
Type: System.IO.SearchOption

Einer der Enumerationswerte, der angibt, ob nur das aktuelle Verzeichnis oder auch alle Unterverzeichnisse durchsucht werden sollen.

Rückgabewert

Type: System.IO.DirectoryInfo[]

Ein Array vom Typ DirectoryInfo, der searchPattern entspricht.

Exception Condition
ArgumentException

searchPattern enthält mindestens ein ungültiges Zeichen gemäß der Definition der GetInvalidPathChars-Methode.

ArgumentNullException

searchPattern ist null.

ArgumentOutOfRangeException

searchOption ist kein gültiger SearchOption-Wert.

DirectoryNotFoundException

Der im DirectoryInfo-Objekt gekapselte Pfad ist ungültig (z. B. befindet er sich auf einem nicht zugeordneten Laufwerk).

UnauthorizedAccessException

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.

searchPattern kann eine Kombination von Literal- und Platzhalterzeichen Zeichen, unterstützt jedoch keine regulären Ausdrücke. Die folgenden Bezeichner für Platzhalter sind zulässig, searchPattern.

Platzhalter-Spezifizierer

Entsprechungen

* (Sternchen)

NULL oder mehr Zeichen an dieser Stelle.

? (Fragezeichen)

0 (null) oder ein Zeichen an dieser Position.

Andere Zeichen als die Platzhalter sind Literalzeichen. Z. B. die Zeichenfolge "* t" sucht nach allen Namen in der mit dem Buchstaben "t" enden. ". Die searchPattern Zeichenfolge "s *" sucht nach allen Namen in path mit dem Buchstaben "s" beginnen.

Wenn keine Unterverzeichnisse vorhanden sind oder keine Unterverzeichnisse entsprechen den searchPattern Parameter dieser Methode ein leeres Array zurück.

Diese Methode füllt vorab die Werte der folgenden DirectoryInfo Eigenschaften:

Im folgenden Beispiel werden alle Verzeichnisse und Dateien, die mit dem Buchstaben "c" in "c:\" beginnen.

using System;
using System.IO;

class App
{
    public static void Main()
    {
        // Specify the directory you want to manipulate.
        string path = @"c:\";
        string searchPattern = "c*";

        DirectoryInfo di = new DirectoryInfo(path);
        DirectoryInfo[] directories = 
            di.GetDirectories(searchPattern, SearchOption.TopDirectoryOnly);

        FileInfo[] files = 
            di.GetFiles(searchPattern, SearchOption.TopDirectoryOnly);

        Console.WriteLine(
            "Directories that begin with the letter \"c\" in {0}", path);
        foreach (DirectoryInfo dir in directories)
        {
            Console.WriteLine(
                "{0,-25} {1,25}", dir.FullName, dir.LastWriteTime);
        }

        Console.WriteLine();
        Console.WriteLine(
            "Files that begin with the letter \"c\" in {0}", path);
        foreach (FileInfo file in files)
        {
            Console.WriteLine(
                "{0,-25} {1,25}", file.Name, file.LastWriteTime);
        }
    } // Main()
} // App()

FileIOPermission

for reading from files and directories and for access to the path. Associated enumerations: F:System.Security.Permissions.FileIOPermissionAccess.Read, F:System.Security.Permissions.FileIOPermissionAccess.PathDiscovery

Universelle Windows-Plattform
Verfügbar seit 10
.NET Framework
Verfügbar seit 2.0
Zurück zum Anfang
Anzeigen: