DirectoryInfo.GetFiles DirectoryInfo.GetFiles DirectoryInfo.GetFiles DirectoryInfo.GetFiles Method

Definition

Gibt eine Dateiliste des aktuellen Verzeichnisses zurück.Returns a file list from the current directory.

Überlädt

GetFiles(String, EnumerationOptions) GetFiles(String, EnumerationOptions) GetFiles(String, EnumerationOptions)
GetFiles(String, SearchOption) GetFiles(String, SearchOption) GetFiles(String, SearchOption)

Gibt eine Dateiliste des aktuellen Verzeichnisses zurück, das dem angegebenen Suchmuster entspricht. Anhand eines Werts wird bestimmt, ob in Unterverzeichnissen gesucht wird.Returns a file list from the current directory matching the given search pattern and using a value to determine whether to search subdirectories.

GetFiles() GetFiles() GetFiles() GetFiles()

Gibt eine Dateiliste des aktuellen Verzeichnisses zurück.Returns a file list from the current directory.

GetFiles(String) GetFiles(String) GetFiles(String) GetFiles(String)

Gibt eine Dateiliste des aktuellen Verzeichnisses zurück, das dem angegebenen Suchmuster entspricht.Returns a file list from the current directory matching the given search pattern.

GetFiles(String, EnumerationOptions) GetFiles(String, EnumerationOptions) GetFiles(String, EnumerationOptions)

public:
 cli::array <System::IO::FileInfo ^> ^ GetFiles(System::String ^ searchPattern, System::IO::EnumerationOptions ^ enumerationOptions);
public System.IO.FileInfo[] GetFiles (string searchPattern, System.IO.EnumerationOptions enumerationOptions);
member this.GetFiles : string * System.IO.EnumerationOptions -> System.IO.FileInfo[]

Parameter

searchPattern
String String String String

Gibt zurück

GetFiles(String, SearchOption) GetFiles(String, SearchOption) GetFiles(String, SearchOption)

Gibt eine Dateiliste des aktuellen Verzeichnisses zurück, das dem angegebenen Suchmuster entspricht. Anhand eines Werts wird bestimmt, ob in Unterverzeichnissen gesucht wird.Returns a file list from the current directory matching the given search pattern and using a value to determine whether to search subdirectories.

public:
 cli::array <System::IO::FileInfo ^> ^ GetFiles(System::String ^ searchPattern, System::IO::SearchOption searchOption);
public System.IO.FileInfo[] GetFiles (string searchPattern, System.IO.SearchOption searchOption);
member this.GetFiles : string * System.IO.SearchOption -> System.IO.FileInfo[]

Parameter

searchPattern
String String String String

Die Suchzeichenfolge für die Überprüfung der Namen von Dateien auf Übereinstimmungen.The search string to match against the names of files. Dieser Parameter kann eine Kombination aus gültigen Literalpfad- und Platzhalterzeichen (* und ?) enthalten, unterstützt jedoch keine regulären Ausdrücke.This parameter can contain a combination of valid literal path and wildcard (* and ?) characters, but it doesn't support regular expressions.

searchOption
SearchOption SearchOption SearchOption SearchOption

Einer der Enumerationswerte, der angibt, ob nur das aktuelle Verzeichnis oder auch alle Unterverzeichnisse durchsucht werden sollen.One of the enumeration values that specifies whether the search operation should include only the current directory or all subdirectories.

Gibt zurück

Ein Array vom Typ FileInfo.An array of type FileInfo.

Ausnahmen

searchPattern enthält mindestens ein ungültiges Zeichen gemäß der Definition der GetInvalidPathChars()-Methode.searchPattern contains one or more invalid characters defined by the GetInvalidPathChars() method.

Der Pfad ist ungültig (z. B. befindet er sich auf einem nicht zugeordneten Laufwerk).The path is invalid (for example, it is on an unmapped drive).

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.The caller does not have the required permission.

Beispiele

Das folgende Beispiel zeigt, wie Sie eine Liste von Dateien aus einem Verzeichnis abrufen, mit unterschiedlichen Suchoptionen.The following example shows how to get a list of files from a directory by using different search options. Im Beispiel wird angenommen, ein Verzeichnis mit Dateien, die mit dem Namen log1.txt "log2.txt", test1.txt, test2.txt, test3.txt und ein Unterverzeichnis, das eine Datei mit dem Namen SubFile.txt hat.The example assumes a directory that has files named log1.txt, log2.txt, test1.txt, test2.txt, test3.txt, and a subdirectory that has a file named SubFile.txt.

using System;
using System.IO;

namespace ConsoleApplication1
{
    class Program
    {
        static void Main(string[] args)
        {
            DirectoryInfo di = new DirectoryInfo(@"C:\Users\tomfitz\Documents\ExampleDir");
            Console.WriteLine("No search pattern returns:");
            foreach (var fi in di.GetFiles())
            {
                Console.WriteLine(fi.Name);
            }

            Console.WriteLine();

            Console.WriteLine("Search pattern *2* returns:");
            foreach (var fi in di.GetFiles("*2*"))
            {
                Console.WriteLine(fi.Name);
            }

            Console.WriteLine();

            Console.WriteLine("Search pattern test?.txt returns:");
            foreach (var fi in di.GetFiles("test?.txt"))
            {
                Console.WriteLine(fi.Name);
            }

            Console.WriteLine();

            Console.WriteLine("Search pattern AllDirectories returns:");
            foreach (var fi in di.GetFiles("*", SearchOption.AllDirectories))
            {
                Console.WriteLine(fi.Name);
            }
        }
    }
}
/* 
This code produces output similar to the following:

No search pattern returns:
log1.txt
log2.txt
test1.txt
test2.txt
test3.txt

Search pattern *2* returns:
log2.txt
test2.txt

Search pattern test?.txt returns:
test1.txt
test2.txt
test3.txt

Search pattern AllDirectories returns:
log1.txt
log2.txt
test1.txt
test2.txt
test3.txt
SubFile.txt
Press any key to continue . . .

*/
Imports System.IO

Module Module1

    Sub Main()
        Dim di As DirectoryInfo = New DirectoryInfo("C:\ExampleDir")
        Console.WriteLine("No search pattern returns:")
        For Each fi In di.GetFiles()
            Console.WriteLine(fi.Name)
        Next

        Console.WriteLine()

        Console.WriteLine("Search pattern *2* returns:")
        For Each fi In di.GetFiles("*2*")
            Console.WriteLine(fi.Name)
        Next

        Console.WriteLine()

        Console.WriteLine("Search pattern test?.txt returns:")
        For Each fi In di.GetFiles("test?.txt")
            Console.WriteLine(fi.Name)
        Next

        Console.WriteLine()

        Console.WriteLine("Search pattern AllDirectories returns:")
        For Each fi In di.GetFiles("*", SearchOption.AllDirectories)
            Console.WriteLine(fi.Name)
        Next
    End Sub

End Module

' This code produces output similar to the following:

' No search pattern returns:
' log1.txt
' log2.txt
' test1.txt
' test2.txt
' test3.txt

' Search pattern *2* returns:
' log2.txt
' test2.txt

' Search pattern test?.txt returns:
' test1.txt
' test2.txt
' test3.txt

' Search pattern AllDirectories returns:
' log1.txt
' log2.txt
' test1.txt
' test2.txt
' test3.txt
' SubFile.txt
' Press any key to continue . . .

Hinweise

Die EnumerateFiles und GetFiles Methoden unterscheiden sich wie folgt:The EnumerateFiles and GetFiles methods differ as follows:

  • Bei Verwendung von EnumerateFiles, können Sie anfangen die Auflistung der FileInfo Objekte, bevor die gesamte Auflistung zurückgegeben wird.When you use EnumerateFiles, you can start enumerating the collection of FileInfo objects before the whole collection is returned.

  • Bei Verwendung von GetFiles, müssen Sie warten, bis das gesamte Array von FileInfo Objekte zurückgegeben werden, bevor Sie das Array zugreifen können.When you use GetFiles, you must wait for the whole array of FileInfo objects to be returned before you can access the array.

Aus diesem Grund werden, wenn Sie arbeiten mit vielen Dateien und Verzeichnissen, EnumerateFiles kann effizienter sein.Therefore, when you are working with many files and directories, EnumerateFiles can be more efficient.

Wenn es keine Dateien in sind die DirectoryInfo, diese Methode gibt ein leeres Array zurück.If there are no files in the DirectoryInfo, this method returns an empty array.

Die folgenden Bezeichner für die Platzhalter sind zulässig, searchPattern.The following wildcard specifiers are permitted in searchPattern.

PlatzhalterzeichenWildcard character Beschreibung Description
* (Sternchen)* (asterisk) NULL oder mehr Zeichen.Zero or more characters.
?? (Fragezeichen)(question mark) Genau 0 (null) oder ein Zeichen.Exactly zero or one character.

Die Reihenfolge der zurückgegebenen Dateinamen ist nicht garantiert werden; Verwenden Sie die Sort Methode, wenn keine bestimmte Sortierreihenfolge erforderlich ist.The order of the returned file names is not guaranteed; use the Sort method if a specific sort order is required.

Platzhalter sind zulässig.Wildcards are permitted. Z. B. die searchPattern Zeichenfolge "*.txt" suchen, für alle Dateinamen, die mit der Erweiterung "Txt".For example, the searchPattern string "*.txt" searches for all file names having an extension of "txt". Die searchPattern Zeichenfolge "s*" sucht nach der alle Dateinamen, die mit dem Buchstaben "s" beginnen.The searchPattern string "s*" searches for all file names beginning with the letter "s". Wenn es keine Dateien oder keine sind Dateien entsprechen der searchPattern in eine Zeichenfolge der DirectoryInfo, diese Methode gibt ein leeres Array zurück.If there are no files, or no files that match the searchPattern string in the DirectoryInfo, this method returns an empty array.

Hinweis

Bei Verwendung des Platzhalterzeichens Sternchen in einem searchPattern (z. B. "*.txt"), das entsprechende Verhalten hängt von der Länge der angegebenen Dateierweiterung.When using the asterisk wildcard character in a searchPattern (for example, "*.txt"), the matching behavior varies depending on the length of the specified file extension. Ein searchPattern mit einer Datei gibt die Erweiterung von genau drei Zeichen Dateien mit der Erweiterung von drei oder mehr Zeichen, die die ersten drei Zeichen, in denen die Dateierweiterung, die im angegebenen überein die searchPattern.A searchPattern with a file extension of exactly three characters returns files with an extension of three or more characters, where the first three characters match the file extension specified in the searchPattern. Ein searchPattern mit einer Datei gibt die Erweiterung von einem, zwei oder mehr als drei Zeichen nur Dateien mit Erweiterungen genau dieser Länge, die die Dateierweiterung, die im angegebenen entsprechen den searchPattern.A searchPattern with a file extension of one, two, or more than three characters returns only files with extensions of exactly that length that match the file extension specified in the searchPattern. Wenn Sie das Fragezeichen-Platzhalterzeichen verwenden, gibt diese Methode nur die Dateien, die die angegebene Dateierweiterung entsprechen.When using the question mark wildcard character, this method returns only files that match the specified file extension. Angenommen, zwei Dateien in ein Verzeichnis, "file1.txt" und "file1.txtother", die einem Suchmuster von "Datei?. TXT"gibt nur die erste Datei, während ein Suchmuster von" Datei*.txt "beide Dateien zurückgegeben.For example, given two files in a directory, "file1.txt" and "file1.txtother", a search pattern of "file?.txt" returns only the first file, while a search pattern of "file*.txt" returns both files.

In der folgende Liste wird das Verhalten der verschiedenen Längen der searchPattern Parameter:The following list shows the behavior of different lengths for the searchPattern parameter:

  • "* .abc" gibt Dateien mit einer Erweiterung of.abc,.abcd,.abcde,.abcdef, und so weiter."*.abc" returns files having an extension of.abc,.abcd,.abcde,.abcdef, and so on.

  • "*.abcd" gibt nur die Dateien, die mit der Erweiterung.abcd zurück."*.abcd" returns only files having an extension of.abcd.

  • "*.abcde" gibt nur die Dateien, die mit der Erweiterung.abcde zurück."*.abcde" returns only files having an extension of.abcde.

  • "*.abcdef" gibt nur die Dateien, die mit der Erweiterung.abcdef zurück."*.abcdef" returns only files having an extension of.abcdef.

Hinweis

Da diese Methode für den Dateinamen mit der der 8.3-Namensformat und Format des lange Datei eincheckt, ein Suchmuster "* 1*.txt" möglicherweise unerwartete Dateinamen zurück.Because this method checks against file names with both the 8.3 file name format and the long file name format, a search pattern similar to "*1*.txt" may return unexpected file names. Verwenden Sie beispielsweise ein Suchmuster von "*1*.txt" "longfilename.txt" wird zurückgegeben, da das Äquivalent der 8.3-Namensformat "longf~1.txt" wäre.For example, using a search pattern of "*1*.txt" will return "longfilename.txt" because the equivalent 8.3 file name format would be "longf~1.txt".

Diese Methode füllt die Werte der folgenden FileInfo Eigenschaften:This method pre-populates the values of the following FileInfo properties:

  1. Attributes

  2. CreationTime

  3. CreationTimeUtc

  4. LastAccessTime

  5. LastAccessTimeUtc

  6. LastWriteTime

  7. LastWriteTimeUtc

  8. Length

Sicherheit

FileIOPermission
für den Zugriff auf den Pfad und zum Lesen aus Dateien und Verzeichnisse.for access to the path and for reading from files and directories. Zugeordnete Enumerationen: Read, PathDiscoveryAssociated enumerations: Read, PathDiscovery

Siehe auch

GetFiles() GetFiles() GetFiles() GetFiles()

Gibt eine Dateiliste des aktuellen Verzeichnisses zurück.Returns a file list from the current directory.

public:
 cli::array <System::IO::FileInfo ^> ^ GetFiles();
public System.IO.FileInfo[] GetFiles ();
member this.GetFiles : unit -> System.IO.FileInfo[]
Public Function GetFiles () As FileInfo()

Gibt zurück

Ein Array vom Typ FileInfo.An array of type FileInfo.

Ausnahmen

Der Pfad ist ungültig. Dies ist z. B. der Fall, wenn das Laufwerk des Pfads nicht zugeordnet ist.The path is invalid, such as being on an unmapped drive.

Beispiele

Das folgende Beispiel zeigt, wie Sie eine Liste von Dateien aus einem Verzeichnis abrufen, mit unterschiedlichen Suchoptionen.The following example shows how to get a list of files from a directory by using different search options. Im Beispiel wird angenommen, ein Verzeichnis mit Dateien, die mit dem Namen log1.txt "log2.txt", test1.txt, test2.txt, test3.txt und ein Unterverzeichnis, das eine Datei mit dem Namen SubFile.txt hat.The example assumes a directory that has files named log1.txt, log2.txt, test1.txt, test2.txt, test3.txt, and a subdirectory that has a file named SubFile.txt.

using System;
using System.IO;

namespace ConsoleApplication1
{
    class Program
    {
        static void Main(string[] args)
        {
            DirectoryInfo di = new DirectoryInfo(@"C:\Users\tomfitz\Documents\ExampleDir");
            Console.WriteLine("No search pattern returns:");
            foreach (var fi in di.GetFiles())
            {
                Console.WriteLine(fi.Name);
            }

            Console.WriteLine();

            Console.WriteLine("Search pattern *2* returns:");
            foreach (var fi in di.GetFiles("*2*"))
            {
                Console.WriteLine(fi.Name);
            }

            Console.WriteLine();

            Console.WriteLine("Search pattern test?.txt returns:");
            foreach (var fi in di.GetFiles("test?.txt"))
            {
                Console.WriteLine(fi.Name);
            }

            Console.WriteLine();

            Console.WriteLine("Search pattern AllDirectories returns:");
            foreach (var fi in di.GetFiles("*", SearchOption.AllDirectories))
            {
                Console.WriteLine(fi.Name);
            }
        }
    }
}
/* 
This code produces output similar to the following:

No search pattern returns:
log1.txt
log2.txt
test1.txt
test2.txt
test3.txt

Search pattern *2* returns:
log2.txt
test2.txt

Search pattern test?.txt returns:
test1.txt
test2.txt
test3.txt

Search pattern AllDirectories returns:
log1.txt
log2.txt
test1.txt
test2.txt
test3.txt
SubFile.txt
Press any key to continue . . .

*/
Imports System.IO

Module Module1

    Sub Main()
        Dim di As DirectoryInfo = New DirectoryInfo("C:\ExampleDir")
        Console.WriteLine("No search pattern returns:")
        For Each fi In di.GetFiles()
            Console.WriteLine(fi.Name)
        Next

        Console.WriteLine()

        Console.WriteLine("Search pattern *2* returns:")
        For Each fi In di.GetFiles("*2*")
            Console.WriteLine(fi.Name)
        Next

        Console.WriteLine()

        Console.WriteLine("Search pattern test?.txt returns:")
        For Each fi In di.GetFiles("test?.txt")
            Console.WriteLine(fi.Name)
        Next

        Console.WriteLine()

        Console.WriteLine("Search pattern AllDirectories returns:")
        For Each fi In di.GetFiles("*", SearchOption.AllDirectories)
            Console.WriteLine(fi.Name)
        Next
    End Sub

End Module

' This code produces output similar to the following:

' No search pattern returns:
' log1.txt
' log2.txt
' test1.txt
' test2.txt
' test3.txt

' Search pattern *2* returns:
' log2.txt
' test2.txt

' Search pattern test?.txt returns:
' test1.txt
' test2.txt
' test3.txt

' Search pattern AllDirectories returns:
' log1.txt
' log2.txt
' test1.txt
' test2.txt
' test3.txt
' SubFile.txt
' Press any key to continue . . .

Hinweise

Die EnumerateFiles und GetFiles Methoden unterscheiden sich wie folgt:The EnumerateFiles and GetFiles methods differ as follows:

  • Bei Verwendung von EnumerateFiles, können Sie anfangen die Auflistung der FileInfo Objekte, bevor die gesamte Auflistung zurückgegeben wird.When you use EnumerateFiles, you can start enumerating the collection of FileInfo objects before the whole collection is returned.

  • Bei Verwendung von GetFiles, müssen Sie warten, bis das gesamte Array von FileInfo Objekte zurückgegeben werden, bevor Sie das Array zugreifen können.When you use GetFiles, you must wait for the whole array of FileInfo objects to be returned before you can access the array.

Aus diesem Grund werden, wenn Sie arbeiten mit vielen Dateien und Verzeichnissen, EnumerateFiles kann effizienter sein.Therefore, when you are working with many files and directories, EnumerateFiles can be more efficient.

Wenn es keine Dateien in sind die DirectoryInfo, diese Methode gibt ein leeres Array zurück.If there are no files in the DirectoryInfo, this method returns an empty array.

Die Reihenfolge der zurückgegebenen Dateinamen ist nicht garantiert werden; Verwenden Sie die Sort Methode, wenn keine bestimmte Sortierreihenfolge erforderlich ist.The order of the returned file names is not guaranteed; use the Sort method if a specific sort order is required.

Diese Methode füllt die Werte der folgenden FileInfo Eigenschaften:This method pre-populates the values of the following FileInfo properties:

Sicherheit

FileIOPermission
zum Lesen von Verzeichnissen.for reading directories. Zugeordnete Enumeration: ReadAssociated enumeration: Read

Siehe auch

GetFiles(String) GetFiles(String) GetFiles(String) GetFiles(String)

Gibt eine Dateiliste des aktuellen Verzeichnisses zurück, das dem angegebenen Suchmuster entspricht.Returns a file list from the current directory matching the given search pattern.

public:
 cli::array <System::IO::FileInfo ^> ^ GetFiles(System::String ^ searchPattern);
public System.IO.FileInfo[] GetFiles (string searchPattern);
member this.GetFiles : string -> System.IO.FileInfo[]
Public Function GetFiles (searchPattern As String) As FileInfo()

Parameter

searchPattern
String String String String

Die Suchzeichenfolge für die Überprüfung der Namen von Dateien auf Übereinstimmungen.The search string to match against the names of files. Dieser Parameter kann eine Kombination aus gültigen Literalpfad- und Platzhalterzeichen (* und ?) enthalten, unterstützt jedoch keine regulären Ausdrücke.This parameter can contain a combination of valid literal path and wildcard (* and ?) characters, but it doesn't support regular expressions.

Gibt zurück

Ein Array vom Typ FileInfo.An array of type FileInfo.

Ausnahmen

searchPattern enthält mindestens ein ungültiges Zeichen gemäß der Definition der GetInvalidPathChars()-Methode.searchPattern contains one or more invalid characters defined by the GetInvalidPathChars() method.

Der Pfad ist ungültig (z. B. befindet er sich auf einem nicht zugeordneten Laufwerk).The path is invalid (for example, it is on an unmapped drive).

Der Aufrufer verfügt nicht über die erforderliche Berechtigung.The caller does not have the required permission.

Beispiele

Das folgende Beispiel zeigt, wie Sie eine Liste von Dateien aus einem Verzeichnis abrufen, mit unterschiedlichen Suchoptionen.The following example shows how to get a list of files from a directory by using different search options. Im Beispiel wird angenommen, ein Verzeichnis mit Dateien, die mit dem Namen log1.txt "log2.txt", test1.txt, test2.txt, test3.txt und ein Unterverzeichnis, das eine Datei mit dem Namen SubFile.txt hat.The example assumes a directory that has files named log1.txt, log2.txt, test1.txt, test2.txt, test3.txt, and a subdirectory that has a file named SubFile.txt.

using System;
using System.IO;

namespace ConsoleApplication1
{
    class Program
    {
        static void Main(string[] args)
        {
            DirectoryInfo di = new DirectoryInfo(@"C:\Users\tomfitz\Documents\ExampleDir");
            Console.WriteLine("No search pattern returns:");
            foreach (var fi in di.GetFiles())
            {
                Console.WriteLine(fi.Name);
            }

            Console.WriteLine();

            Console.WriteLine("Search pattern *2* returns:");
            foreach (var fi in di.GetFiles("*2*"))
            {
                Console.WriteLine(fi.Name);
            }

            Console.WriteLine();

            Console.WriteLine("Search pattern test?.txt returns:");
            foreach (var fi in di.GetFiles("test?.txt"))
            {
                Console.WriteLine(fi.Name);
            }

            Console.WriteLine();

            Console.WriteLine("Search pattern AllDirectories returns:");
            foreach (var fi in di.GetFiles("*", SearchOption.AllDirectories))
            {
                Console.WriteLine(fi.Name);
            }
        }
    }
}
/* 
This code produces output similar to the following:

No search pattern returns:
log1.txt
log2.txt
test1.txt
test2.txt
test3.txt

Search pattern *2* returns:
log2.txt
test2.txt

Search pattern test?.txt returns:
test1.txt
test2.txt
test3.txt

Search pattern AllDirectories returns:
log1.txt
log2.txt
test1.txt
test2.txt
test3.txt
SubFile.txt
Press any key to continue . . .

*/
Imports System.IO

Module Module1

    Sub Main()
        Dim di As DirectoryInfo = New DirectoryInfo("C:\ExampleDir")
        Console.WriteLine("No search pattern returns:")
        For Each fi In di.GetFiles()
            Console.WriteLine(fi.Name)
        Next

        Console.WriteLine()

        Console.WriteLine("Search pattern *2* returns:")
        For Each fi In di.GetFiles("*2*")
            Console.WriteLine(fi.Name)
        Next

        Console.WriteLine()

        Console.WriteLine("Search pattern test?.txt returns:")
        For Each fi In di.GetFiles("test?.txt")
            Console.WriteLine(fi.Name)
        Next

        Console.WriteLine()

        Console.WriteLine("Search pattern AllDirectories returns:")
        For Each fi In di.GetFiles("*", SearchOption.AllDirectories)
            Console.WriteLine(fi.Name)
        Next
    End Sub

End Module

' This code produces output similar to the following:

' No search pattern returns:
' log1.txt
' log2.txt
' test1.txt
' test2.txt
' test3.txt

' Search pattern *2* returns:
' log2.txt
' test2.txt

' Search pattern test?.txt returns:
' test1.txt
' test2.txt
' test3.txt

' Search pattern AllDirectories returns:
' log1.txt
' log2.txt
' test1.txt
' test2.txt
' test3.txt
' SubFile.txt
' Press any key to continue . . .

Hinweise

searchPattern kann eine Kombination von Literal-und Platzhalterzeichen, jedoch werden reguläre Ausdrücke nicht unterstützt.searchPattern can be a combination of literal and wildcard characters, but it doesn't support regular expressions. Die folgenden Bezeichner für die Platzhalter sind zulässig, searchPattern.The following wildcard specifiers are permitted in searchPattern.

Platzhalter-SpezifiziererWildcard specifier ÜbereinstimmungenMatches
* (Sternchen)* (asterisk) NULL oder mehr Zeichen an dieser Position.Zero or more characters in that position.
?? (Fragezeichen)(question mark) Kein oder ein Zeichen an dieser Position.Zero or one character in that position.

Andere Zeichen als Platzhalter lauten wie folgt.Characters other than the wildcard are literal characters. Z. B. die Zeichenfolge "* t" sucht nach allen Namen mit dem Buchstaben "t" beendet.For example, the string "*t" searches for all names in ending with the letter "t". Die searchPattern Zeichenfolge "s*" sucht nach allen Namen in path mit dem Buchstaben "s" beginnen.The searchPattern string "s*" searches for all names in path beginning with the letter "s".

Die EnumerateFiles und GetFiles Methoden unterscheiden sich wie folgt:The EnumerateFiles and GetFiles methods differ as follows:

  • Bei Verwendung von EnumerateFiles, können Sie anfangen die Auflistung der FileInfo Objekte, bevor die gesamte Auflistung zurückgegeben wird.When you use EnumerateFiles, you can start enumerating the collection of FileInfo objects before the whole collection is returned.

  • Bei Verwendung von GetFiles, müssen Sie warten, bis das gesamte Array von FileInfo Objekte zurückgegeben werden, bevor Sie das Array zugreifen können.When you use GetFiles, you must wait for the whole array of FileInfo objects to be returned before you can access the array.

Aus diesem Grund werden, wenn Sie arbeiten mit vielen Dateien und Verzeichnissen, EnumerateFiles kann effizienter sein.Therefore, when you are working with many files and directories, EnumerateFiles can be more efficient.

Wenn es keine Dateien in sind die DirectoryInfo, diese Methode gibt ein leeres Array zurück.If there are no files in the DirectoryInfo, this method returns an empty array.

Die folgenden Bezeichner für die Platzhalter sind zulässig, der searchPattern Parameter.The following wildcard specifiers are permitted in the searchPattern parameter.

PlatzhalterzeichenWildcard character Beschreibung Description
* NULL oder mehr Zeichen.Zero or more characters.
?? Genau 0 (null) oder ein Zeichen.Exactly zero or one character.

Die Reihenfolge der zurückgegebenen Dateinamen ist nicht garantiert werden; Verwenden Sie die Sort Methode, wenn keine bestimmte Sortierreihenfolge erforderlich ist.The order of the returned file names is not guaranteed; use the Sort method if a specific sort order is required.

Platzhalter sind zulässig.Wildcards are permitted. Z. B. die searchPattern Zeichenfolge "*.txt" suchen, für alle Dateinamen, die mit der Erweiterung "Txt".For example, the searchPattern string "*.txt" searches for all file names having an extension of "txt". Die searchPattern Zeichenfolge "s*" sucht nach der alle Dateinamen, die mit dem Buchstaben "s" beginnen.The searchPattern string "s*" searches for all file names beginning with the letter "s". Wenn es keine Dateien oder keine sind Dateien entsprechen der searchPattern in eine Zeichenfolge der DirectoryInfo, diese Methode gibt ein leeres Array zurück.If there are no files, or no files that match the searchPattern string in the DirectoryInfo, this method returns an empty array.

Hinweis

Bei Verwendung des Platzhalterzeichens Sternchen in einem searchPattern (z. B. "*.txt"), das entsprechende Verhalten hängt von der Länge der angegebenen Dateierweiterung.When using the asterisk wildcard character in a searchPattern (for example, "*.txt"), the matching behavior varies depending on the length of the specified file extension. Ein searchPattern mit einer Datei gibt die Erweiterung von genau drei Zeichen Dateien mit der Erweiterung von drei oder mehr Zeichen, die die ersten drei Zeichen, in denen die Dateierweiterung, die im angegebenen überein die searchPattern.A searchPattern with a file extension of exactly three characters returns files with an extension of three or more characters, where the first three characters match the file extension specified in the searchPattern. Ein searchPattern mit einer Datei gibt die Erweiterung von einem, zwei oder mehr als drei Zeichen nur Dateien mit Erweiterungen genau dieser Länge, die die Dateierweiterung, die im angegebenen entsprechen den searchPattern.A searchPattern with a file extension of one, two, or more than three characters returns only files with extensions of exactly that length that match the file extension specified in the searchPattern. Wenn Sie das Fragezeichen-Platzhalterzeichen verwenden, gibt diese Methode nur die Dateien, die die angegebene Dateierweiterung entsprechen.When using the question mark wildcard character, this method returns only files that match the specified file extension. Angenommen, zwei Dateien in ein Verzeichnis, "file1.txt" und "file1.txtother", die einem Suchmuster von "Datei?. TXT"gibt nur die erste Datei, während ein Suchmuster von" Datei*.txt "beide Dateien zurückgegeben.For example, given two files in a directory, "file1.txt" and "file1.txtother", a search pattern of "file?.txt" returns only the first file, while a search pattern of "file*.txt" returns both files.

Hinweis

Da diese Methode für den Dateinamen mit der der 8.3-Namensformat und Format des lange Datei eincheckt, ein Suchmuster "* 1*.txt" möglicherweise unerwartete Dateinamen zurück.Because this method checks against file names with both the 8.3 file name format and the long file name format, a search pattern similar to "*1*.txt" may return unexpected file names. Verwenden Sie beispielsweise ein Suchmuster von "*1*.txt" "longfilename.txt" wird zurückgegeben, da das Äquivalent der 8.3-Namensformat "longf~1.txt" wäre.For example, using a search pattern of "*1*.txt" will return "longfilename.txt" because the equivalent 8.3 file name format would be "longf~1.txt".

Diese Methode füllt die Werte der folgenden FileInfo Eigenschaften:This method pre-populates the values of the following FileInfo properties:

Sicherheit

FileIOPermission
für den Zugriff auf den Pfad und zum Lesen aus Dateien und Verzeichnisse.for access to the path and for reading from files and directories. Zugeordnete Enumerationen: Read, PathDiscoveryAssociated enumerations: Read, PathDiscovery

Siehe auch

Gilt für: