Directory.GetFiles Метод

Ссылка

Определение

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

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

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

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

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Важно!

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

Возвращает имена файлов, соответствующих указанным критериям.

Перегрузки

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

GetFiles(String)

Исходный код:: Directory.cs

Исходный код:: Directory.cs

Исходный код:: Directory.cs

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

public:
 static cli::array <System::String ^> ^ GetFiles(System::String ^ path);

public static string[] GetFiles (string path);

static member GetFiles : string -> string[]

Public Shared Function GetFiles (path As String) As String()

Параметры

path: String

Относительный или абсолютный путь к каталогу для поиска. В этой строке не учитывается регистр знаков.

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

String[]

Массив полных имен (включая пути) файлов в указанном каталоге или пустой массив, если файлы не найдены.

Исключения

IOException

path — это имя файла.

-или-

Произошла сетевая ошибка.

UnauthorizedAccessException

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

ArgumentException

Версии .NET Framework и .NET Core старше 2.1: path строка нулевой длины, содержит только пробелы или содержит один или несколько недопустимых символов. Вы можете запросить недопустимые символы с помощью метода GetInvalidPathChars().

ArgumentNullException

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

PathTooLongException

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

DirectoryNotFoundException

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

Примеры

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

// For Directory::GetFiles and Directory::GetDirectories
// For File::Exists, Directory::Exists
using namespace System;
using namespace System::IO;
using namespace System::Collections;

// Insert logic for processing found files here.
void ProcessFile( String^ path )
{
   Console::WriteLine( "Processed file '{0}'.", path );
}


// Process all files in the directory passed in, recurse on any directories 
// that are found, and process the files they contain.
void ProcessDirectory( String^ targetDirectory )
{
   
   // Process the list of files found in the directory.
   array<String^>^fileEntries = Directory::GetFiles( targetDirectory );
   IEnumerator^ files = fileEntries->GetEnumerator();
   while ( files->MoveNext() )
   {
      String^ fileName = safe_cast<String^>(files->Current);
      ProcessFile( fileName );
   }

   
   // Recurse into subdirectories of this directory.
   array<String^>^subdirectoryEntries = Directory::GetDirectories( targetDirectory );
   IEnumerator^ dirs = subdirectoryEntries->GetEnumerator();
   while ( dirs->MoveNext() )
   {
      String^ subdirectory = safe_cast<String^>(dirs->Current);
      ProcessDirectory( subdirectory );
   }
}

int main( int argc, char *argv[] )
{
   for ( int i = 1; i < argc; i++ )
   {
      String^ path = gcnew String(argv[ i ]);
      if ( File::Exists( path ) )
      {
         
         // This path is a file
         ProcessFile( path );
      }
      else
      if ( Directory::Exists( path ) )
      {
         
         // This path is a directory
         ProcessDirectory( path );
      }
      else
      {
         Console::WriteLine( "{0} is not a valid file or directory.", path );
      }

   }
}

// For Directory.GetFiles and Directory.GetDirectories
// For File.Exists, Directory.Exists
using System;
using System.IO;
using System.Collections;

public class RecursiveFileProcessor
{
    public static void Main(string[] args)
    {
        foreach(string path in args)
        {
            if(File.Exists(path))
            {
                // This path is a file
                ProcessFile(path);
            }
            else if(Directory.Exists(path))
            {
                // This path is a directory
                ProcessDirectory(path);
            }
            else
            {
                Console.WriteLine("{0} is not a valid file or directory.", path);
            }
        }
    }

    // Process all files in the directory passed in, recurse on any directories
    // that are found, and process the files they contain.
    public static void ProcessDirectory(string targetDirectory)
    {
        // Process the list of files found in the directory.
        string [] fileEntries = Directory.GetFiles(targetDirectory);
        foreach(string fileName in fileEntries)
            ProcessFile(fileName);

        // Recurse into subdirectories of this directory.
        string [] subdirectoryEntries = Directory.GetDirectories(targetDirectory);
        foreach(string subdirectory in subdirectoryEntries)
            ProcessDirectory(subdirectory);
    }

    // Insert logic for processing found files here.
    public static void ProcessFile(string path)
    {
        Console.WriteLine("Processed file '{0}'.", path);	
    }
}

module RecursiveFileProcessor

open System.IO

// Insert logic for processing found files here.
let processFile path =
    printfn $"Processed file '%s{path}'."

// Process all files in the directory passed in, recurse on any directories
// that are found, and process the files they contain.
let rec processDirectory targetDirectory =
    // Process the list of files found in the directory.
    let fileEntries = Directory.GetFiles targetDirectory
    for fileName in fileEntries do
        processFile fileName

    // Recurse into subdirectories of this directory.
    let subdirectoryEntries = Directory.GetDirectories targetDirectory
    for subdirectory in subdirectoryEntries do
        processDirectory subdirectory

[<EntryPoint>]
let main args =
    for path in args do
        if File.Exists path then
            // This path is a file
            processFile path
        elif Directory.Exists path then
            // This path is a directory
            processDirectory path
        else
            printfn $"{path} is not a valid file or directory."
    0

' For Directory.GetFiles and Directory.GetDirectories
' For File.Exists, Directory.Exists 

Imports System.IO
Imports System.Collections

Public Class RecursiveFileProcessor

    Public Overloads Shared Sub Main(ByVal args() As String)
        Dim path As String
        For Each path In args
            If File.Exists(path) Then
                ' This path is a file.
                ProcessFile(path)
            Else
                If Directory.Exists(path) Then
                    ' This path is a directory.
                    ProcessDirectory(path)
                Else
                    Console.WriteLine("{0} is not a valid file or directory.", path)
                End If
            End If
        Next path
    End Sub


    ' Process all files in the directory passed in, recurse on any directories 
    ' that are found, and process the files they contain.
    Public Shared Sub ProcessDirectory(ByVal targetDirectory As String)
        Dim fileEntries As String() = Directory.GetFiles(targetDirectory)
        ' Process the list of files found in the directory.
        Dim fileName As String
        For Each fileName In fileEntries
            ProcessFile(fileName)

        Next fileName
        Dim subdirectoryEntries As String() = Directory.GetDirectories(targetDirectory)
        ' Recurse into subdirectories of this directory.
        Dim subdirectory As String
        For Each subdirectory In subdirectoryEntries
            ProcessDirectory(subdirectory)
        Next subdirectory

    End Sub

    ' Insert logic for processing found files here.
    Public Shared Sub ProcessFile(ByVal path As String)
        Console.WriteLine("Processed file '{0}'.", path)
    End Sub
End Class

Методы EnumerateFiles и GetFiles отличаются следующим образом: при использовании EnumerateFilesможно начать перечисление коллекции имен перед возвратом всей коллекции. При использовании GetFilesнеобходимо дождаться возврата всего массива имен, прежде чем получить доступ к массиву. Таким образом, при работе с большим количеством файлов и каталогов EnumerateFiles может быть более эффективным.

Возвращенные имена файлов добавляются к указанному path параметру.

Этот метод идентичен GetFiles(String, String) звездочку (*), указанную в качестве шаблона поиска.

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

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

Чувствительность параметра к регистру path соответствует значению файловой системы, в которой выполняется код. Например, регистр не учитывается в NTFS (файловая система Windows по умолчанию) и учитывает регистр в файловых системах Linux.

Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.

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

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

GetFiles(String, String)

Исходный код:: Directory.cs

Исходный код:: Directory.cs

Исходный код:: Directory.cs

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

public:
 static cli::array <System::String ^> ^ GetFiles(System::String ^ path, System::String ^ searchPattern);

public static string[] GetFiles (string path, string searchPattern);

static member GetFiles : string * string -> string[]

Public Shared Function GetFiles (path As String, searchPattern As String) As String()

Параметры

path: String

Относительный или абсолютный путь к каталогу для поиска. В этой строке не учитывается регистр знаков.

searchPattern: String

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

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

String[]

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

Исключения

IOException

path — это имя файла.

-или-

Произошла сетевая ошибка.

UnauthorizedAccessException

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

ArgumentException

-или-

searchPattern не содержит допустимый шаблон.

ArgumentNullException

Параметр path или searchPattern имеет значение null.

PathTooLongException

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

DirectoryNotFoundException

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

Примеры

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

using namespace System;
using namespace System::IO;
int main()
{
   try
   {
      
      // Only get files that begin with the letter "c".
      array<String^>^dirs = Directory::GetFiles( "c:\\", "c*" );
      Console::WriteLine( "The number of files starting with c is {0}.", dirs->Length );
      Collections::IEnumerator^ myEnum = dirs->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         Console::WriteLine( myEnum->Current );
      }
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "The process failed: {0}", e );
   }

}

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        try
        {
            // Only get files that begin with the letter "c".
            string[] dirs = Directory.GetFiles(@"c:\", "c*");
            Console.WriteLine("The number of files starting with c is {0}.", dirs.Length);
            foreach (string dir in dirs)
            {
                Console.WriteLine(dir);
            }
        }
        catch (Exception e)
        {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    }
}

open System.IO

try
    // Only get files that begin with the letter "c".
    let dirs = Directory.GetFiles(@"c:\", "c*")
    printfn $"The number of files starting with c is {dirs.Length}."
    for dir in dirs do
        printfn $"{dir}"
with e ->
    printfn $"The process failed: {e}"

Imports System.IO

Public Class Test
    Public Shared Sub Main()
        Try
            ' Only get files that begin with the letter "c".
            Dim dirs As String() = Directory.GetFiles("c:\", "c*")
            Console.WriteLine("The number of files starting with c is {0}.", dirs.Length)
            Dim dir As String
            For Each dir In dirs
                Console.WriteLine(dir)
            Next
        Catch e As Exception
            Console.WriteLine("The process failed: {0}", e.ToString())
        End Try
    End Sub
End Class

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

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

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

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

searchPattern не может заканчиваться двумя точками ("..") или содержать две точки (".."), за которыми следует DirectorySeparatorChar или AltDirectorySeparatorChar, и не может содержать недопустимые символы. Вы можете запросить недопустимые символы с помощью метода GetInvalidPathChars.

Примечание

Только .NET Framework: Если вы используете подстановочный знак звездочки в searchPattern и указываете расширение файла из трех символов, например "*.txt", этот метод также возвращает файлы с расширениями, начинающимися с указанного расширения. Например, шаблон поиска "*.xls" возвращает значения "book.xls" и "book.xlsx". Это происходит только в том случае, если в шаблоне поиска используется звездочка, а предоставленное расширение файла содержит ровно три символа. Если в шаблоне поиска используется подстановочный знак вопросительного знака, этот метод возвращает только те файлы, которые точно соответствуют указанному расширению файла. В следующей таблице показана эта аномалия в .NET Framework.

Файлы в каталоге	Шаблон поиска	.NET 5 и более поздних версий возвращает	.NET Framework возвращает
file.ai, file.aif	*.Ai	file.ai	file.ai
book.xls, book.xlsx	*.xls	book.xls	book.xls, book.xlsx
ello.txt, hello.txt, hello.txtt	?ello.txt	hello.txt	hello.txt

Примечание

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

Учет регистра path параметра соответствует значению файловой системы, в которой выполняется код. Например, регистр не учитывается в NTFS (файловая система Windows по умолчанию) и учитывается регистр в файловых системах Linux.

Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.

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

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

GetFiles(String, String, EnumerationOptions)

Исходный код:: Directory.cs

Исходный код:: Directory.cs

Исходный код:: Directory.cs

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

public:
 static cli::array <System::String ^> ^ GetFiles(System::String ^ path, System::String ^ searchPattern, System::IO::EnumerationOptions ^ enumerationOptions);

public static string[] GetFiles (string path, string searchPattern, System.IO.EnumerationOptions enumerationOptions);

static member GetFiles : string * string * System.IO.EnumerationOptions -> string[]

Public Shared Function GetFiles (path As String, searchPattern As String, enumerationOptions As EnumerationOptions) As String()

Параметры

path: String

Относительный или абсолютный путь к каталогу для поиска. В этой строке не учитывается регистр знаков.

searchPattern: String

Строка поиска, которая должна сравниваться с именами файлов в path. Этот параметр может содержать сочетание допустимых литеральных и подстановочных символов, но не поддерживает регулярные выражения.

enumerationOptions: EnumerationOptions

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

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

String[]

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

Исключения

IOException

path — это имя файла.

-или-

Произошла сетевая ошибка.

UnauthorizedAccessException

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

ArgumentException

.NET Framework и .NET Core версий старше 2.1: path строка нулевой длины, содержит только пробелы или содержит один или несколько недопустимых символов. Вы можете запросить недопустимые символы с помощью GetInvalidPathChars().

-или-

searchPattern не содержит допустимый шаблон.

ArgumentNullException

Параметр path или searchPattern имеет значение null.

PathTooLongException

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

DirectoryNotFoundException

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

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

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

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

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

searchPattern не может заканчиваться двумя точками ("..") или содержать две точки (".."), за которыми DirectorySeparatorChar следует или AltDirectorySeparatorChar, и не может содержать недопустимые символы. Вы можете запросить недопустимые символы с помощью метода GetInvalidPathChars.

Примечание

Только .NET Framework: При использовании подстановочного знака звездочки в и searchPattern указании расширения файла из трех символов, например "*.txt", этот метод также возвращает файлы с расширениями, начинающимися с указанного расширения. Например, шаблон поиска "*.xls" возвращает как "book.xls", так и "book.xlsx". Это происходит только в том случае, если в шаблоне поиска используется звездочка, а расширение файла содержит ровно три символа. Если в шаблоне поиска используется подстановочный знак вопросительного знака, этот метод возвращает только файлы, которые точно соответствуют указанному расширению файла. В следующей таблице показана эта аномалия в .NET Framework.

Файлы в каталоге	Шаблон поиска	.NET 5+ возвращает	.NET Framework возвращает
file.ai, file.aif	*.Ai	file.ai	file.ai
book.xls, book.xlsx	*.xls	book.xls	book.xls, book.xlsx
ello.txt, hello.txt, hello.txtt	?ello.txt	hello.txt	hello.txt

Примечание

Методы EnumerateFiles и GetFiles отличаются следующим образом: при использовании EnumerateFilesможно начать перечисление коллекции имен до возвращения всей коллекции; при использовании GetFilesнеобходимо дождаться возвращения всего массива имен, прежде чем получить доступ к массиву. Таким образом, при работе с большим количеством файлов и каталогов EnumerateFiles может быть более эффективным.

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

Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.

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

GetFiles(String, String, SearchOption)

Исходный код:: Directory.cs

Исходный код:: Directory.cs

Исходный код:: Directory.cs

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

public:
 static cli::array <System::String ^> ^ GetFiles(System::String ^ path, System::String ^ searchPattern, System::IO::SearchOption searchOption);

public static string[] GetFiles (string path, string searchPattern, System.IO.SearchOption searchOption);

static member GetFiles : string * string * System.IO.SearchOption -> string[]

Public Shared Function GetFiles (path As String, searchPattern As String, searchOption As SearchOption) As String()

Параметры

path: String

Относительный или абсолютный путь к каталогу для поиска. В этой строке не учитывается регистр знаков.

searchPattern: String

searchOption: SearchOption

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

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

String[]

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

Исключения

ArgumentException

-или-

searchPattern не содержит допустимый шаблон.

ArgumentNullException

Параметр path или searchpattern имеет значение null.

ArgumentOutOfRangeException

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

UnauthorizedAccessException

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

DirectoryNotFoundException

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

PathTooLongException

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

IOException

path — это имя файла.

-или-

Произошла сетевая ошибка.

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

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

Примечание

Файлы в каталоге	Шаблон поиска	.NET 5+ возвращает	.NET Framework возвращает
file.ai, file.aif	*.Ai	file.ai	file.ai
book.xls, book.xlsx	*.xls	book.xls	book.xls, book.xlsx
ello.txt, hello.txt, hello.txtt	?ello.txt	hello.txt	hello.txt

Примечание

Имена файлов включают полный путь.

Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.

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

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

Поделиться через

Directory.GetFiles Метод

Определение

Перегрузки

GetFiles(String)

Параметры

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

Исключения

Примеры

Комментарии

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

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

GetFiles(String, String)

Параметры

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

Исключения

Примеры

Комментарии

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

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

GetFiles(String, String, EnumerationOptions)

Параметры

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

Исключения

Комментарии

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

GetFiles(String, String, SearchOption)

Параметры

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

Исключения

Комментарии

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

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

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