DirectoryInfo.GetFiles Метод

Ссылка

Определение

Пространство имен:: System.IO

Сборка:: System.IO.FileSystem.dll

Сборка:: System.Runtime.dll

Сборка:: netstandard.dll

Сборки:: mscorlib.dll, System.IO.FileSystem.dll

Сборка:: mscorlib.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Возвращает список файлов текущего каталога.

Перегрузки

GetFiles(String, EnumerationOptions)	Возвращает список файлов из текущего каталога, соответствующий указанному шаблону поиска и параметрам перечисления.
GetFiles(String, SearchOption)	Возвращает список файлов из текущего каталога, соответствующих заданному шаблону поиска, с использованием значения, которое позволяет определить, следует ли выполнять поиск в подкаталогах.
GetFiles()	Возвращает список файлов текущего каталога.
GetFiles(String)	Возвращает список файлов текущего каталога, соответствующих заданному шаблону поиска.

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[]

Public Function GetFiles (searchPattern As String, enumerationOptions As EnumerationOptions) As FileInfo()

Параметры

searchPattern: String

Строка поиска, которая будет сравниваться с именами файлов. Этот параметр может содержать сочетание допустимого литерального пути и подстановочного символа (* и ?), но не поддерживает регулярные выражения.

enumerationOptions: EnumerationOptions

Объект, описывающий конфигурацию поиска и перечисления для использования.

Возвращаемое значение

FileInfo[]

Массив строго типизированных объектов FileInfo, соответствующий searchPattern и enumerationOptions.

Исключения

ArgumentException

платформа .NET Framework и .NET версии Core старше 2.1: searchPattern содержит один или несколько недопустимых символов, определенных методомGetInvalidPathChars().

ArgumentNullException

searchPattern имеет значение null.

DirectoryNotFoundException

Недопустимый путь (например, указывающий на несопоставленный диск).

SecurityException

У вызывающего объекта отсутствует необходимое разрешение.

searchPattern может быть сочетанием литеральных и подстановочных знаков, но не поддерживает регулярные выражения. Следующие описатели подстановочных знаков разрешены в searchPattern.

Описатель подстановочных знаков	Соответствует
* (звездочка)	Ноль или более символов в этой позиции.
? (вопросительный знак)	Ноль или один символ в этой позиции.

Символы, отличные от подстановочного знака, являются литеральными символами. Например, строка "*t" выполняет поиск всех имен в конце буквы "t". Строка searchPattern "s*" выполняет поиск всех имен, path начиная с буквы "s".

Методы EnumerateFiles отличаются GetFiles следующим образом:

При использовании EnumerateFilesможно начать перечисление коллекции FileInfo объектов до возвращения всей коллекции.
При использовании GetFilesнеобходимо дождаться возвращения всего массива FileInfo объектов, прежде чем получить доступ к массиву.

Таким образом, при работе с большим количеством файлов и каталогов EnumerateFiles может быть более эффективным.

Если в нем DirectoryInfoнет файлов, этот метод возвращает пустой массив.

Следующие описатели подстановочных знаков разрешены в параметре searchPattern .

Символ-шаблон	Описание
*	Ноль или более символов.
?	Ровно ноль или один символ.

Порядок возвращенных имен файлов не гарантируется; используйте метод, Sort если требуется определенный порядок сортировки.

Разрешено использовать подстановочные знаки. Например, searchPattern строка "*.txt" выполняет поиск всех имен файлов с расширением txt. Строка searchPattern "s*" выполняет поиск всех имен файлов, начиная с буквы "s". Если в строке нет файлов или нет файлов, которые соответствуют searchPattern строке DirectoryInfo, этот метод возвращает пустой массив.

Примечание

При использовании подстановочного знака звездочки в searchPattern (например, "*.txt"), соответствующее поведение зависит от длины указанного расширения файла. С searchPattern расширением файла ровно три символа возвращают файлы с расширением из трех символов, где первые три символа соответствуют расширению файла, указанному в файле searchPattern. Файл searchPattern с расширением одного, двух или более трех символов возвращает только файлы с расширениями точно такой длины, которые соответствуют расширению файла, указанному в параметре searchPattern. При использовании подстановочного знака вопроса этот метод возвращает только файлы, соответствующие указанному расширению файла. Например, при выполнении двух файлов в каталоге "file1.txt" и "file1.txtother" шаблон поиска "file?.txt" возвращает только первый файл, а шаблон поиска "file*.txt" возвращает оба файла.

Примечание

Так как этот метод проверяет имена файлов с форматом имени файла 8.3 и форматом длинного имени файла, шаблон поиска, аналогичный "*1*.txt", может возвращать непредвиденные имена файлов. Например, при использовании шаблона поиска "*1*.txt" возвращается "longfilename.txt", так как эквивалентный формат имени файла 8.3 будет "longf~1.txt".

Этот метод предварительно заполняет значения следующих FileInfo свойств:

Применяется к

GetFiles(String, SearchOption)

Возвращает список файлов из текущего каталога, соответствующих заданному шаблону поиска, с использованием значения, которое позволяет определить, следует ли выполнять поиск в подкаталогах.

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[]

Public Function GetFiles (searchPattern As String, searchOption As SearchOption) As FileInfo()

Параметры

searchPattern: String

searchOption: SearchOption

Одно из значений перечисления, определяющее, следует ли выполнять поиск только в текущем каталоге или также во всех его подкаталогах.

Возвращаемое значение

FileInfo[]

Массив типа FileInfo.

Исключения

ArgumentException

ArgumentNullException

searchPattern имеет значение null.

ArgumentOutOfRangeException

searchOption не является допустимым значением SearchOption.

DirectoryNotFoundException

Недопустимый путь (например, указывающий на несопоставленный диск).

SecurityException

У вызывающего объекта отсутствует необходимое разрешение.

Примеры

В следующем примере показано, как получить список файлов из каталога с помощью различных параметров поиска. В этом примере предполагается каталог с файлами с именем log1.txt, log2.txt, test1.txt, test2.txt, test3.txt и подкаталогом с именем 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 . . .

*/

open System.IO

let di = DirectoryInfo @"C:\Users\tomfitz\Documents\ExampleDir"
printfn "No search pattern returns:"
for fi in di.GetFiles() do
    printfn $"{fi.Name}"

printfn "\nSearch pattern *2* returns:"
for fi in di.GetFiles "*2*" do
    printfn $"{fi.Name}"

printfn "\nSearch pattern test?.txt returns:"
for fi in di.GetFiles "test?.txt" do
    printfn $"{fi.Name}"

printfn "\nSearch pattern AllDirectories returns:"
for fi in di.GetFiles("*", SearchOption.AllDirectories) do
    printfn $"{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 . . .

При использовании EnumerateFilesможно начать перечисление коллекции FileInfo объектов до возвращения всей коллекции.
При использовании GetFilesнеобходимо дождаться возвращения всего массива FileInfo объектов, прежде чем получить доступ к массиву.

Таким образом, при работе с большим количеством файлов и каталогов EnumerateFiles может быть более эффективным.

Если в нем DirectoryInfoнет файлов, этот метод возвращает пустой массив.

Следующие описатели подстановочных знаков разрешены в searchPattern.

Символ-шаблон	Описание
* (звездочка)	Ноль или более символов.
? (вопросительный знак)	Ровно ноль или один символ.

Примечание

В следующем списке показано поведение различных длин для searchPattern параметра:

"*.abc" возвращает файлы с расширением .abc,abcd,.abcde,.abcdef и т. д.
"*.abcd" возвращает только файлы с расширением ABCD.
"*.abcde" возвращает только файлы с расширением ABCDE.
"*.abcdef" возвращает только файлы с расширением abcdef.

Примечание

Этот метод предварительно заполняет значения следующих FileInfo свойств:

См. также раздел

Применяется к

GetFiles()

Возвращает список файлов текущего каталога.

public:
 cli::array <System::IO::FileInfo ^> ^ GetFiles();

public System.IO.FileInfo[] GetFiles ();

member this.GetFiles : unit -> System.IO.FileInfo[]

Public Function GetFiles () As FileInfo()

Возвращаемое значение

FileInfo[]

Массив типа FileInfo.

Исключения

DirectoryNotFoundException

Недопустимый путь (например, он ведет на несопоставленный диск).

Примеры

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 . . .

*/

open System.IO

let di = DirectoryInfo @"C:\Users\tomfitz\Documents\ExampleDir"
printfn "No search pattern returns:"
for fi in di.GetFiles() do
    printfn $"{fi.Name}"

printfn "\nSearch pattern *2* returns:"
for fi in di.GetFiles "*2*" do
    printfn $"{fi.Name}"

printfn "\nSearch pattern test?.txt returns:"
for fi in di.GetFiles "test?.txt" do
    printfn $"{fi.Name}"

printfn "\nSearch pattern AllDirectories returns:"
for fi in di.GetFiles("*", SearchOption.AllDirectories) do
    printfn $"{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 . . .

При использовании EnumerateFilesможно начать перечисление коллекции FileInfo объектов до возвращения всей коллекции.
При использовании GetFilesнеобходимо дождаться возвращения всего массива FileInfo объектов, прежде чем получить доступ к массиву.

Таким образом, при работе с большим количеством файлов и каталогов EnumerateFiles может быть более эффективным.

Если в нем DirectoryInfoнет файлов, этот метод возвращает пустой массив.

Этот метод предварительно заполняет значения следующих FileInfo свойств:

См. также раздел

Применяется к

GetFiles(String)

Возвращает список файлов текущего каталога, соответствующих заданному шаблону поиска.

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()

Параметры

searchPattern: String

Возвращаемое значение

FileInfo[]

Массив типа FileInfo.

Исключения

ArgumentException

ArgumentNullException

searchPattern имеет значение null.

DirectoryNotFoundException

Недопустимый путь (например, указывающий на несопоставленный диск).

SecurityException

У вызывающего объекта отсутствует необходимое разрешение.

Примеры

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 . . .

*/

open System.IO

let di = DirectoryInfo @"C:\Users\tomfitz\Documents\ExampleDir"
printfn "No search pattern returns:"
for fi in di.GetFiles() do
    printfn $"{fi.Name}"

printfn "\nSearch pattern *2* returns:"
for fi in di.GetFiles "*2*" do
    printfn $"{fi.Name}"

printfn "\nSearch pattern test?.txt returns:"
for fi in di.GetFiles "test?.txt" do
    printfn $"{fi.Name}"

printfn "\nSearch pattern AllDirectories returns:"
for fi in di.GetFiles("*", SearchOption.AllDirectories) do
    printfn $"{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 . . .

При использовании EnumerateFilesможно начать перечисление коллекции FileInfo объектов до возвращения всей коллекции.
При использовании GetFilesнеобходимо дождаться возвращения всего массива FileInfo объектов, прежде чем получить доступ к массиву.

Таким образом, при работе с большим количеством файлов и каталогов EnumerateFiles может быть более эффективным.

Если в нем DirectoryInfoнет файлов, этот метод возвращает пустой массив.

Следующие описатели подстановочных знаков разрешены в параметре searchPattern .

Символ-шаблон	Описание
*	Ноль или более символов.
?	Ровно ноль или один символ.

Примечание

Этот метод предварительно заполняет значения следующих FileInfo свойств:

См. также раздел

Применяется к

DirectoryInfo.GetFiles Метод

Определение

Перегрузки

GetFiles(String, EnumerationOptions)

Параметры

Возвращаемое значение

Исключения

Комментарии

Применяется к

GetFiles(String, SearchOption)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

См. также раздел

Применяется к

GetFiles()

Возвращаемое значение

Исключения

Примеры

Комментарии

См. также раздел

Применяется к

GetFiles(String)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

См. также раздел

Применяется к

Дополнительные ресурсы