DirectoryInfo.EnumerateFileSystemInfos Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает перечисляемую коллекцию сведений о файловой системе текущего каталога.
Перегрузки
| EnumerateFileSystemInfos(String, SearchOption) |
Возвращает перечисляемую коллекцию сведений о файловой системе, соответствующую указанному шаблону поиска и параметру поиска в подкаталогах. |
| EnumerateFileSystemInfos() |
Возвращает перечисляемую коллекцию сведений о файловой системе текущего каталога. |
| EnumerateFileSystemInfos(String) |
Возвращает перечисляемую коллекцию сведений о файловой системе, соответствующую указанному шаблону поиска. |
| EnumerateFileSystemInfos(String, EnumerationOptions) |
Возвращает перечисляемую коллекцию сведений о файловой системе, соответствующую указанному шаблону поиска и параметрам перечисления. |
EnumerateFileSystemInfos(String, SearchOption)
- Исходный код:
- 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 коллекции будет запускать новое перечисление.
См. также раздел
Применяется к
EnumerateFileSystemInfos()
- Исходный код:
- 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 коллекции будет запускать новое перечисление.
См. также раздел
Применяется к
EnumerateFileSystemInfos(String)
- Исходный код:
- 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 коллекции будет запускать новое перечисление.
См. также раздел
Применяется к
EnumerateFileSystemInfos(String, EnumerationOptions)
- Исходный код:
- 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 коллекции будет запускать новое перечисление.
