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