Directory.EnumerateFileSystemEntries Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает перечисленную коллекцию записей файловой системы, удовлетворяющих указанным критериям.
Перегрузки
| Имя | Описание |
|---|---|
| EnumerateFileSystemEntries(String) |
Возвращает перечисленную коллекцию имен файлов и имен каталогов в указанном пути. |
| EnumerateFileSystemEntries(String, String) |
Возвращает перечисленную коллекцию имен файлов и имен каталогов, которые соответствуют шаблону поиска в указанном пути. |
| EnumerateFileSystemEntries(String, String, EnumerationOptions) |
Возвращает перечисленную коллекцию имен файлов и имен каталогов, которые соответствуют шаблону поиска и параметрам перечисления в указанном пути. |
| EnumerateFileSystemEntries(String, String, SearchOption) |
Возвращает перечисляемую коллекцию имен файлов и имен каталогов, соответствующих шаблону поиска в указанном пути, и при необходимости выполняет поиск подкаталогов. |
EnumerateFileSystemEntries(String)
- Исходный код:
- Directory.cs
- Исходный код:
- Directory.cs
- Исходный код:
- Directory.cs
- Исходный код:
- Directory.cs
- Исходный код:
- Directory.cs
Возвращает перечисленную коллекцию имен файлов и имен каталогов в указанном пути.
public:
static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path);public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries(string path);static member EnumerateFileSystemEntries : string -> seq<string>Public Shared Function EnumerateFileSystemEntries (path As String) As IEnumerable(Of String)Параметры
- path
- String
Относительный или абсолютный путь к каталогу для поиска. Эта строка не учитывает регистр.
Возвращаемое значение
Перечисленная коллекция записей файловой системы в каталоге, заданном path.
Исключения
.NET Framework и .NET Core версии старше 2.1: path является строкой нулевой длины, содержит только пробелы или содержит недопустимые символы. Вы можете запросить недопустимые символы с помощью метода GetInvalidPathChars().
path равно null.
path является недопустимым, например ссылкой на несопоставленный диск.
path — это имя файла.
Указанный путь, имя файла или объединенное превышение заданной системой максимальной длины.
Вызывающий объект не имеет требуемого разрешения.
Вызывающий объект не имеет требуемого разрешения.
Комментарии
Можно указать относительные сведения о пути с параметром path . Относительные сведения о пути интерпретируются как относительные к текущему рабочему каталогу GetCurrentDirectory , который можно определить с помощью метода.
Методы EnumerateFileSystemEntries отличаются следующим образом: при использовании GetFileSystemEntriesможно начать перечисление коллекции записей до возврата всей коллекции. При использовании EnumerateFileSystemEntriesнеобходимо дождаться возврата всего массива записей, прежде чем получить доступ к массиву.GetFileSystemEntries Поэтому при работе с большим количеством файлов и каталогов EnumerateFileSystemEntries может быть более эффективным.
Возвращенная коллекция не кэшируется; каждый вызов GetEnumerator коллекции запустит новое перечисление.
Применяется к
EnumerateFileSystemEntries(String, String)
- Исходный код:
- Directory.cs
- Исходный код:
- Directory.cs
- Исходный код:
- Directory.cs
- Исходный код:
- Directory.cs
- Исходный код:
- Directory.cs
Возвращает перечисленную коллекцию имен файлов и имен каталогов, которые соответствуют шаблону поиска в указанном пути.
public:
static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path, System::String ^ searchPattern);public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries(string path, string searchPattern);static member EnumerateFileSystemEntries : string * string -> seq<string>Public Shared Function EnumerateFileSystemEntries (path As String, searchPattern As String) As IEnumerable(Of String)Параметры
- path
- String
Относительный или абсолютный путь к каталогу для поиска. Эта строка не учитывает регистр.
- searchPattern
- String
Строка поиска, соответствующая именам записей файловой системы в path. Этот параметр может содержать сочетание допустимых символов литерала и подстановочных знаков (* и ?), но не поддерживает регулярные выражения.
Возвращаемое значение
Перечисленная коллекция записей файловой системы в каталоге, заданном path и соответствующая указанному шаблону поиска.
Исключения
.NET Framework и .NET Core версии старше 2.1: path является строкой нулевой длины, содержит только пробелы или содержит недопустимые символы. Вы можете запросить недопустимые символы с помощью метода GetInvalidPathChars().
–или–
searchPattern не содержит допустимый шаблон.
path является недопустимым, например ссылкой на несопоставленный диск.
path — это имя файла.
Указанный путь, имя файла или объединенное превышение заданной системой максимальной длины.
Вызывающий объект не имеет требуемого разрешения.
Вызывающий объект не имеет требуемого разрешения.
Комментарии
searchPattern может быть сочетанием символов литерала и подстановочных знаков, но не поддерживает регулярные выражения. Следующие описатели подстановочных знаков разрешены в searchPattern.
| Описатель подстановочных знаков | Совпадения |
|---|---|
| * (звездочка) | Ноль или больше символов в этой позиции. |
| ? (вопросительный знак) | Ровно один символ в этой позиции. |
Символы, отличные от подстановочного знака, являются литеральными символами. Например, searchPattern строка "*t" выполняет поиск всех имен в path конце буквы "t". Строка searchPattern "s*" выполняет поиск всех имен, path начиная с буквы "s".
Note
При использовании подстановочного знака звездочки в searchPattern таком виде, как "*.txt", количество символов в указанном расширении влияет на поиск следующим образом:
- Если указанное расширение составляет ровно три символа, метод возвращает файлы с расширениями, начинающимися с указанного расширения. Например, "*.xls" возвращает оба "book.xls" и "book.xlsx".
- Во всех остальных случаях метод возвращает файлы, которые точно соответствуют указанному расширению. Например, "*.ai" возвращает значение "file.ai", но не "file.aif".
При использовании подстановочного знака вопроса этот метод возвращает только файлы, соответствующие указанному расширению файла. Например, учитывая два файла, "file1.txt" и "file1.txtother", в каталоге шаблон поиска "file?.txtвозвращает только первый файл, а шаблон поиска "file*.txt" возвращает оба файла.
searchPattern не может заканчиваться двумя периодами ("..") или содержать два периода (".).), за которыми следует DirectorySeparatorChar или AltDirectorySeparatorCharне может содержать недопустимые символы. Вы можете запросить недопустимые символы с помощью метода GetInvalidPathChars.
Можно указать относительные сведения о пути с параметром path . Относительные сведения о пути интерпретируются как относительные к текущему рабочему каталогу GetCurrentDirectory , который можно определить с помощью метода.
Методы EnumerateFileSystemEntries отличаются следующим образом: при использовании GetFileSystemEntriesможно начать перечисление коллекции записей до возврата всей коллекции. При использовании EnumerateFileSystemEntriesнеобходимо дождаться возврата всего массива записей, прежде чем получить доступ к массиву.GetFileSystemEntries Поэтому при работе с большим количеством файлов и каталогов EnumerateFileSystemEntries может быть более эффективным.
Возвращенная коллекция не кэшируется; каждый вызов GetEnumerator коллекции запустит новое перечисление.
Применяется к
EnumerateFileSystemEntries(String, String, EnumerationOptions)
- Исходный код:
- Directory.cs
- Исходный код:
- Directory.cs
- Исходный код:
- Directory.cs
- Исходный код:
- Directory.cs
- Исходный код:
- Directory.cs
Возвращает перечисленную коллекцию имен файлов и имен каталогов, которые соответствуют шаблону поиска и параметрам перечисления в указанном пути.
public:
static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path, System::String ^ searchPattern, System::IO::EnumerationOptions ^ enumerationOptions);public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries(string path, string searchPattern, System.IO.EnumerationOptions enumerationOptions);static member EnumerateFileSystemEntries : string * string * System.IO.EnumerationOptions -> seq<string>Public Shared Function EnumerateFileSystemEntries (path As String, searchPattern As String, enumerationOptions As EnumerationOptions) As IEnumerable(Of String)Параметры
- path
- String
Относительный или абсолютный путь к каталогу для поиска. Эта строка не учитывает регистр.
- searchPattern
- String
Строка поиска, соответствующая именам файлов и каталогов.path Этот параметр может содержать сочетание допустимых литеральных и подстановочных знаков, но не поддерживает регулярные выражения.
- enumerationOptions
- EnumerationOptions
Объект, описывающий конфигурацию поиска и перечисления для использования.
Возвращаемое значение
Перечисленная коллекция записей файловой системы в каталоге, заданном в pathсоответствии с указанным шаблоном поиска и указанными параметрами перечисления.
Исключения
.NET Framework и .NET Core версии старше 2.1: path является строкой нулевой длины, содержит только пробелы или содержит недопустимые символы. Вы можете запросить недопустимые символы с помощью метода GetInvalidPathChars().
–или–
searchPattern не содержит допустимый шаблон.
path является недопустимым, например ссылкой на несопоставленный диск.
path — это имя файла.
Указанный путь, имя файла или объединенное превышение заданной системой максимальной длины.
Вызывающий объект не имеет требуемого разрешения.
Вызывающий объект не имеет требуемого разрешения.
Комментарии
searchPattern может быть сочетанием символов литерала и подстановочных знаков, но не поддерживает регулярные выражения. Следующие описатели подстановочных знаков разрешены в searchPattern.
| Описатель подстановочных знаков | Совпадения |
|---|---|
| * (звездочка) | Ноль или больше символов в этой позиции. |
| ? (вопросительный знак) | Ровно один символ в этой позиции. |
Символы, отличные от подстановочного знака, являются литеральными символами. Например, searchPattern строка "*t" выполняет поиск всех имен в path конце буквы "t". Строка searchPattern "s*" выполняет поиск всех имен, path начиная с буквы "s".
Note
При использовании подстановочного знака звездочки в searchPattern таком виде, как "*.txt", количество символов в указанном расширении влияет на поиск следующим образом:
- Если указанное расширение составляет ровно три символа, метод возвращает файлы с расширениями, начинающимися с указанного расширения. Например, "*.xls" возвращает оба "book.xls" и "book.xlsx".
- Во всех остальных случаях метод возвращает файлы, которые точно соответствуют указанному расширению. Например, "*.ai" возвращает значение "file.ai", но не "file.aif".
При использовании подстановочного знака вопроса этот метод возвращает только файлы, соответствующие указанному расширению файла. Например, учитывая два файла, "file1.txt" и "file1.txtother", в каталоге шаблон поиска "file?.txtвозвращает только первый файл, а шаблон поиска "file*.txt" возвращает оба файла.
searchPattern не может заканчиваться двумя периодами ("..") или содержать два периода (".).), за которыми следует DirectorySeparatorChar или AltDirectorySeparatorCharне может содержать недопустимые символы. Вы можете запросить недопустимые символы с помощью метода GetInvalidPathChars.
Можно указать относительные сведения о пути с параметром path . Относительные сведения о пути интерпретируются как относительные к текущему рабочему каталогу GetCurrentDirectory , который можно определить с помощью метода.
Методы EnumerateFileSystemEntries отличаются следующим образом: при использовании GetFileSystemEntriesможно начать перечисление коллекции записей до возврата всей коллекции. При использовании EnumerateFileSystemEntriesнеобходимо дождаться возврата всего массива записей, прежде чем получить доступ к массиву.GetFileSystemEntries Поэтому при работе с большим количеством файлов и каталогов EnumerateFileSystemEntries может быть более эффективным.
Возвращенная коллекция не кэшируется; каждый вызов GetEnumerator коллекции запустит новое перечисление.
Применяется к
EnumerateFileSystemEntries(String, String, SearchOption)
- Исходный код:
- Directory.cs
- Исходный код:
- Directory.cs
- Исходный код:
- Directory.cs
- Исходный код:
- Directory.cs
- Исходный код:
- Directory.cs
Возвращает перечисляемую коллекцию имен файлов и имен каталогов, соответствующих шаблону поиска в указанном пути, и при необходимости выполняет поиск подкаталогов.
public:
static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path, System::String ^ searchPattern, System::IO::SearchOption searchOption);public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries(string path, string searchPattern, System.IO.SearchOption searchOption);static member EnumerateFileSystemEntries : string * string * System.IO.SearchOption -> seq<string>Public Shared Function EnumerateFileSystemEntries (path As String, searchPattern As String, searchOption As SearchOption) As IEnumerable(Of String)Параметры
- path
- String
Относительный или абсолютный путь к каталогу для поиска. Эта строка не учитывает регистр.
- searchPattern
- String
Строка поиска, соответствующая записям pathфайловой системы. Этот параметр может содержать сочетание допустимых символов литерала и подстановочных знаков (* и ?), но не поддерживает регулярные выражения.
- searchOption
- SearchOption
Одно из значений перечисления, указывающее, должна ли операция поиска включать только текущий каталог или включать все подкаталоги. Значение по умолчанию — TopDirectoryOnly.
Возвращаемое значение
Перечисленная коллекция записей файловой системы в каталоге, заданном path и соответствующая указанному шаблону поиска и параметру.
Исключения
.NET Framework и .NET Core версии старше 2.1: path является строкой нулевой длины, содержит только пробелы или содержит недопустимые символы. Вы можете запросить недопустимые символы с помощью метода GetInvalidPathChars().
–или–
searchPattern не содержит допустимый шаблон.
searchOption недопустимое SearchOption значение.
path является недопустимым, например ссылкой на несопоставленный диск.
path — это имя файла.
Указанный путь, имя файла или объединенное превышение заданной системой максимальной длины.
Вызывающий объект не имеет требуемого разрешения.
Вызывающий объект не имеет требуемого разрешения.
Комментарии
searchPattern может быть сочетанием символов литерала и подстановочных знаков, но не поддерживает регулярные выражения. Следующие описатели подстановочных знаков разрешены в searchPattern.
| Описатель подстановочных знаков | Совпадения |
|---|---|
| * (звездочка) | Ноль или больше символов в этой позиции. |
| ? (вопросительный знак) | Ровно один символ в этой позиции. |
Символы, отличные от подстановочного знака, являются литеральными символами. Например, searchPattern строка "*t" выполняет поиск всех имен в path конце буквы "t". Строка searchPattern "s*" выполняет поиск всех имен, path начиная с буквы "s".
Note
При использовании подстановочного знака звездочки в searchPattern таком виде, как "*.txt", количество символов в указанном расширении влияет на поиск следующим образом:
- Если указанное расширение составляет ровно три символа, метод возвращает файлы с расширениями, начинающимися с указанного расширения. Например, "*.xls" возвращает оба "book.xls" и "book.xlsx".
- Во всех остальных случаях метод возвращает файлы, которые точно соответствуют указанному расширению. Например, "*.ai" возвращает значение "file.ai", но не "file.aif".
При использовании подстановочного знака вопроса этот метод возвращает только файлы, соответствующие указанному расширению файла. Например, учитывая два файла, "file1.txt" и "file1.txtother", в каталоге шаблон поиска "file?.txtвозвращает только первый файл, а шаблон поиска "file*.txt" возвращает оба файла.
searchPattern не может заканчиваться двумя периодами ("..") или содержать два периода (".).), за которыми следует DirectorySeparatorChar или AltDirectorySeparatorCharне может содержать недопустимые символы. Вы можете запросить недопустимые символы с помощью метода GetInvalidPathChars.
Можно указать относительные сведения о пути с параметром path . Относительные сведения о пути интерпретируются как относительные к текущему рабочему каталогу GetCurrentDirectory , который можно определить с помощью метода.
Методы EnumerateFileSystemEntries отличаются следующим образом: при использовании GetFileSystemEntriesможно начать перечисление коллекции записей до возврата всей коллекции. При использовании EnumerateFileSystemEntriesнеобходимо дождаться возврата всего массива записей, прежде чем получить доступ к массиву.GetFileSystemEntries Поэтому при работе с большим количеством файлов и каталогов EnumerateFileSystemEntries может быть более эффективным.
Возвращенная коллекция не кэшируется; каждый вызов GetEnumerator коллекции запустит новое перечисление.
