DirectoryInfo.EnumerateFileSystemInfos Метод
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает перечисляемую коллекцию сведений о файловой системе текущего каталога.
EnumerateFileSystemInfos(String, SearchOption) |
Возвращает перечисляемую коллекцию сведений о файловой системе, соответствующую указанному шаблону поиска и параметру поиска в подкаталогах. |
EnumerateFileSystemInfos() |
Возвращает перечисляемую коллекцию сведений о файловой системе текущего каталога. |
EnumerateFileSystemInfos(String) |
Возвращает перечисляемую коллекцию сведений о файловой системе, соответствующую указанному шаблону поиска. |
EnumerateFileSystemInfos(String, EnumerationOptions) |
Возвращает перечисляемую коллекцию сведений о файловой системе, соответствующую указанному шаблону поиска и параметрам перечисления. |
- Исходный код:
- DirectoryInfo.cs
- Исходный код:
- DirectoryInfo.cs
- Исходный код:
- DirectoryInfo.cs
Возвращает перечисляемую коллекцию сведений о файловой системе, соответствующую указанному шаблону поиска и параметру поиска в подкаталогах.
public:
System::Collections::Generic::IEnumerable<System::IO::FileSystemInfo ^> ^ EnumerateFileSystemInfos(System::String ^ searchPattern, System::IO::SearchOption searchOption);
public System.Collections.Generic.IEnumerable<System.IO.FileSystemInfo> EnumerateFileSystemInfos (string searchPattern, System.IO.SearchOption searchOption);
member this.EnumerateFileSystemInfos : string * System.IO.SearchOption -> seq<System.IO.FileSystemInfo>
Public Function EnumerateFileSystemInfos (searchPattern As String, searchOption As SearchOption) As IEnumerable(Of FileSystemInfo)
Параметры
- searchPattern
- String
Строка поиска, которая будет сравниваться с именами каталогов. Этот параметр может содержать сочетание допустимого литерального пути и подстановочного символа (* и ?), но не поддерживает регулярные выражения.
- searchOption
- SearchOption
Одно из значений перечисления, определяющее, следует ли выполнять поиск только в текущем каталоге или также во всех его подкаталогах. Значение по умолчанию — TopDirectoryOnly.
Возвращаемое значение
Перечисляемая коллекция сведений об объектах файловой системы, соответствующая параметру searchPattern
и searchOption
.
Исключения
searchPattern
имеет значение null
.
searchOption
не является допустимым значением SearchOption.
Путь, содержащийся в объекте DirectoryInfo , является недействительным (например, он ведет на несопоставленный диск).
У вызывающего объекта отсутствует необходимое разрешение.
Комментарии
searchPattern
может быть сочетанием литеральных и подстановочных знаков, но не поддерживает регулярные выражения. Следующие описатели с подстановочными знаками разрешены в searchPattern
.
Описатель подстановочных знаков | Соответствует |
---|---|
* (звездочка) | Ноль или более символов в этой позиции. |
? (вопросительный знак) | Ноль или один символ в этой позиции. |
Символы, отличные от подстановочного знака, являются литеральными символами. Например, строка "*t" ищет все имена, заканчивающиеся буквой "t". ". Строка searchPattern
"s*" ищет все имена, path
начинающиеся с буквы "s".
Методы EnumerateFileSystemInfos и GetFileSystemInfos отличаются следующим образом:
При использовании EnumerateFileSystemInfosможно начать перечисление коллекции FileSystemInfo объектов до возвращения всей коллекции.
При использовании GetFileSystemInfosнеобходимо дождаться возвращения всего массива FileSystemInfo объектов, прежде чем получить доступ к массиву.
Таким образом, при работе с большим количеством файлов и каталогов EnumerateFileSystemInfos может быть более эффективным.
Этот метод предварительно заполняет значения следующих FileSystemInfo свойств:
Возвращаемая коллекция не кэшируется; Каждый вызов метода в GetEnumerator коллекции будет запускать новое перечисление.
См. также раздел
Применяется к
.NET 9 и другие версии
Продукт | Версии |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 1.3, 1.4, 1.6, 2.0, 2.1 |
UWP | 10.0 |
- Исходный код:
- DirectoryInfo.cs
- Исходный код:
- DirectoryInfo.cs
- Исходный код:
- DirectoryInfo.cs
Возвращает перечисляемую коллекцию сведений о файловой системе текущего каталога.
public:
System::Collections::Generic::IEnumerable<System::IO::FileSystemInfo ^> ^ EnumerateFileSystemInfos();
public System.Collections.Generic.IEnumerable<System.IO.FileSystemInfo> EnumerateFileSystemInfos ();
member this.EnumerateFileSystemInfos : unit -> seq<System.IO.FileSystemInfo>
Public Function EnumerateFileSystemInfos () As IEnumerable(Of FileSystemInfo)
Возвращаемое значение
Перечисляемая коллекция сведений о файловой системе текущего каталога.
Исключения
Путь, содержащийся в объекте DirectoryInfo , является недействительным (например, он ведет на несопоставленный диск).
У вызывающего объекта отсутствует необходимое разрешение.
Комментарии
Методы EnumerateFileSystemInfos и GetFileSystemInfos отличаются следующим образом:
При использовании EnumerateFileSystemInfosможно начать перечисление коллекции FileSystemInfo объектов до возвращения всей коллекции.
При использовании GetFileSystemInfosнеобходимо дождаться возвращения всего массива FileSystemInfo объектов, прежде чем получить доступ к массиву.
Таким образом, при работе с большим количеством файлов и каталогов EnumerateFileSystemInfos может быть более эффективным.
Этот метод предварительно заполняет значения следующих FileSystemInfo свойств:
Возвращаемая коллекция не кэшируется; Каждый вызов метода в GetEnumerator коллекции будет запускать новое перечисление.
См. также раздел
Применяется к
.NET 9 и другие версии
Продукт | Версии |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 1.3, 1.4, 1.6, 2.0, 2.1 |
UWP | 10.0 |
- Исходный код:
- DirectoryInfo.cs
- Исходный код:
- DirectoryInfo.cs
- Исходный код:
- DirectoryInfo.cs
Возвращает перечисляемую коллекцию сведений о файловой системе, соответствующую указанному шаблону поиска.
public:
System::Collections::Generic::IEnumerable<System::IO::FileSystemInfo ^> ^ EnumerateFileSystemInfos(System::String ^ searchPattern);
public System.Collections.Generic.IEnumerable<System.IO.FileSystemInfo> EnumerateFileSystemInfos (string searchPattern);
member this.EnumerateFileSystemInfos : string -> seq<System.IO.FileSystemInfo>
Public Function EnumerateFileSystemInfos (searchPattern As String) As IEnumerable(Of FileSystemInfo)
Параметры
- searchPattern
- String
Строка поиска, которая будет сравниваться с именами каталогов. Этот параметр может содержать сочетание допустимого литерального пути и подстановочного символа (* и ?), но не поддерживает регулярные выражения.
Возвращаемое значение
Перечисляемая коллекция сведений об объектах файловой системы, соответствующая параметру searchPattern
.
Исключения
searchPattern
имеет значение null
.
Путь, содержащийся в объекте DirectoryInfo , является недействительным (например, он ведет на несопоставленный диск).
У вызывающего объекта отсутствует необходимое разрешение.
Комментарии
searchPattern
может быть сочетанием литеральных и подстановочных знаков, но не поддерживает регулярные выражения. Следующие описатели с подстановочными знаками разрешены в searchPattern
.
Описатель подстановочных знаков | Соответствует |
---|---|
* (звездочка) | Ноль или более символов в этой позиции. |
? (вопросительный знак) | Ноль или один символ в этой позиции. |
Символы, отличные от подстановочного знака, являются литеральными символами. Например, строка "*t" ищет все имена, заканчивающиеся буквой "t". ". Строка searchPattern
"s*" ищет все имена, path
начинающиеся с буквы "s".
Методы EnumerateFileSystemInfos и GetFileSystemInfos отличаются следующим образом:
При использовании EnumerateFileSystemInfosможно начать перечисление коллекции FileSystemInfo объектов до возвращения всей коллекции.
При использовании GetFileSystemInfosнеобходимо дождаться возвращения всего массива FileSystemInfo объектов, прежде чем получить доступ к массиву.
Таким образом, при работе с большим количеством файлов и каталогов EnumerateFileSystemInfos может быть более эффективным.
Этот метод предварительно заполняет значения следующих FileSystemInfo свойств:
Возвращаемая коллекция не кэшируется; Каждый вызов метода в GetEnumerator коллекции будет запускать новое перечисление.
См. также раздел
Применяется к
.NET 9 и другие версии
Продукт | Версии |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 1.3, 1.4, 1.6, 2.0, 2.1 |
UWP | 10.0 |
- Исходный код:
- DirectoryInfo.cs
- Исходный код:
- DirectoryInfo.cs
- Исходный код:
- DirectoryInfo.cs
Возвращает перечисляемую коллекцию сведений о файловой системе, соответствующую указанному шаблону поиска и параметрам перечисления.
public:
System::Collections::Generic::IEnumerable<System::IO::FileSystemInfo ^> ^ EnumerateFileSystemInfos(System::String ^ searchPattern, System::IO::EnumerationOptions ^ enumerationOptions);
public System.Collections.Generic.IEnumerable<System.IO.FileSystemInfo> EnumerateFileSystemInfos (string searchPattern, System.IO.EnumerationOptions enumerationOptions);
member this.EnumerateFileSystemInfos : string * System.IO.EnumerationOptions -> seq<System.IO.FileSystemInfo>
Public Function EnumerateFileSystemInfos (searchPattern As String, enumerationOptions As EnumerationOptions) As IEnumerable(Of FileSystemInfo)
Параметры
- searchPattern
- String
Строка поиска, которая будет сравниваться с именами каталогов. Этот параметр может содержать сочетание допустимого литерального пути и подстановочного символа (* и ?), но не поддерживает регулярные выражения.
- enumerationOptions
- EnumerationOptions
Объект, описывающий конфигурацию поиска и перечисления для использования.
Возвращаемое значение
Перечисляемая коллекция сведений об объектах файловой системы, соответствующая параметру searchPattern
и enumerationOptions
.
Исключения
searchPattern
имеет значение null
.
Путь, содержащийся в объекте DirectoryInfo , является недействительным (например, он ведет на несопоставленный диск).
У вызывающего объекта отсутствует необходимое разрешение.
Комментарии
searchPattern
может быть сочетанием литеральных и подстановочных знаков, но не поддерживает регулярные выражения. Следующие описатели с подстановочными знаками разрешены в searchPattern
.
Описатель подстановочных знаков | Соответствует |
---|---|
* (звездочка) | Ноль или более символов в этой позиции. |
? (вопросительный знак) | Ноль или один символ в этой позиции. |
Символы, отличные от подстановочного знака, являются литеральными символами. Например, строка "*t" ищет все имена, заканчивающиеся буквой "t". ". Строка searchPattern
"s*" ищет все имена, path
начинающиеся с буквы "s".
Методы EnumerateFileSystemInfos и GetFileSystemInfos отличаются следующим образом:
При использовании EnumerateFileSystemInfosможно начать перечисление коллекции FileSystemInfo объектов до возвращения всей коллекции.
При использовании GetFileSystemInfosнеобходимо дождаться возвращения всего массива FileSystemInfo объектов, прежде чем получить доступ к массиву.
Таким образом, при работе с большим количеством файлов и каталогов EnumerateFileSystemInfos может быть более эффективным.
Этот метод предварительно заполняет значения следующих FileSystemInfo свойств:
Возвращаемая коллекция не кэшируется; Каждый вызов метода в GetEnumerator коллекции будет запускать новое перечисление.
Применяется к
.NET 9 и другие версии
Продукт | Версии |
---|---|
.NET | Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Standard | 2.1 |
Отзыв о .NET
.NET — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв: