Exportieren (0) Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

DirectoryInfo.GetDirectories-Methode (String, SearchOption)

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
Typ: System.String
Die Suchzeichenfolge in Anpassung an die Namen von Verzeichnissen. Dieser Parameter kann eine Kombination von gültigen literalen Pfads und Platzhalter(* und?) Zeichen enthält (siehe Hinweise), unterstützt jedoch nicht reguläre Ausdrücke. Das Standardmuster ist "*", wobei alle Dateien zurückgegeben werden.
searchOption
Typ: System.IO.SearchOption
Einer der Enumerationswerte, der angibt, ob nur das aktuelle Verzeichnis oder auch alle Unterverzeichnisse durchsucht werden sollen.

Rückgabewert

Typ: System.IO.DirectoryInfo[]
Ein Array vom Typ DirectoryInfo, der searchPattern entspricht.

AusnahmeBedingung
ArgumentException

searchPattern enthält mindestens ein von der GetInvalidPathChars-Methode definiertes ungültiges Zeichen.

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 des Literals und Platzhalterzeichen sein, unterstützt aber keine regulären Ausdrücke. Die folgenden Bezeichner für Platzhalter sind in searchPattern zulässig.

Platzhalterspezifizierer

Übereinstimmungen

* (Sternchen)

0 oder mehr Zeichen an dieser Stelle.

? (Fragezeichen)

Null oder ein Zeichen an dieser Position.

Zeichen als dem Platzhalter sind Literalzeichen. Beispielsweise die Zeichenfolge "*t" Sucht alle Namen im Ende mit dem Buchstaben "t". ". Mit der searchPattern-Zeichenfolge "s*" werden alle Namen in path gesucht, die mit dem Buchstaben "s" beginnen.

Wenn keine Unterverzeichnisse vorhanden sind oder keine Unterverzeichnisse dem searchPattern-Parameter entsprechen, gibt diese Methode ein leeres Array zurück.

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

Im folgenden Beispiel werden alle Verzeichnisse und Dateien in "c:\" aufgelistet, die mit dem Buchstaben "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()


.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2015 Microsoft