DirectoryInfo.EnumerateFileSystemInfos Метод

Определение

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

System.IO

Сборки:

mscorlib.dll, System.IO.FileSystem.dll

Сборка:

System.IO.FileSystem.dll

Сборка:

System.Runtime.dll

Сборка:

mscorlib.dll

Сборка:

netstandard.dll

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

Перегрузки

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.

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

IEnumerable<FileSystemInfo>

Перечисляемая коллекция сведений об объектах файловой системы, соответствующая параметру searchPattern и searchOption.

Исключения

ArgumentNullException

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

ArgumentOutOfRangeException

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

DirectoryNotFoundException

Путь, содержащийся в объекте DirectoryInfo , является недействительным (например, он ведет на несопоставленный диск).

SecurityException

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

Комментарии

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

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

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

Методы EnumerateFileSystemInfos отличаются GetFileSystemInfos следующим образом:

• При использовании EnumerateFileSystemInfosможно начать перечисление коллекции FileSystemInfo объектов до возвращения всей коллекции.

• При использовании GetFileSystemInfosнеобходимо дождаться возвращения всего массива FileSystemInfo объектов, прежде чем получить доступ к массиву.

Таким образом, при работе с большим количеством файлов и каталогов EnumerateFileSystemInfos может быть более эффективным.

Этот метод предварительно заполняет значения следующих FileSystemInfo свойств:

• Attributes

• CreationTime

• CreationTimeUtc

• LastAccessTime

• LastAccessTimeUtc

• LastWriteTime

• LastWriteTimeUtc

Возвращаемая коллекция не кэшируется; каждый вызов GetEnumerator метода в коллекции запустит новое перечисление.

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

• FileSystemWatcher

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)

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

IEnumerable<FileSystemInfo>

Перечисляемая коллекция сведений о файловой системе текущего каталога.

Исключения

DirectoryNotFoundException

Путь, содержащийся в объекте DirectoryInfo , является недействительным (например, он ведет на несопоставленный диск).

SecurityException

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

Комментарии

Методы EnumerateFileSystemInfos и GetFileSystemInfos методы различаются следующим образом:

• При использовании EnumerateFileSystemInfosможно начать перечисление коллекции FileSystemInfo объектов перед возвратом всей коллекции.

• При использовании GetFileSystemInfosнеобходимо дождаться возвращения всего массива FileSystemInfo объектов, прежде чем получить доступ к массиву.

Таким образом, при работе с большим количеством файлов и каталогов EnumerateFileSystemInfos может быть более эффективным.

Этот метод предварительно заполняет значения следующих FileSystemInfo свойств:

• Attributes

• CreationTime

• CreationTimeUtc

• LastAccessTime

• LastAccessTimeUtc

• LastWriteTime

• LastWriteTimeUtc

Возвращаемая коллекция не кэшируется; Каждый вызов GetEnumerator метода в коллекции запустит новое перечисление.

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

• FileSystemWatcher

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

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

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

IEnumerable<FileSystemInfo>

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

Исключения

ArgumentNullException

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

DirectoryNotFoundException

Путь, содержащийся в объекте DirectoryInfo , является недействительным (например, он ведет на несопоставленный диск).

SecurityException

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

Комментарии

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

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

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

Методы EnumerateFileSystemInfos и GetFileSystemInfos методы различаются следующим образом:

• При использовании EnumerateFileSystemInfosможно начать перечисление коллекции FileSystemInfo объектов перед возвратом всей коллекции.

• При использовании GetFileSystemInfosнеобходимо дождаться возвращения всего массива FileSystemInfo объектов, прежде чем получить доступ к массиву.

Таким образом, при работе с большим количеством файлов и каталогов EnumerateFileSystemInfos может быть более эффективным.

Этот метод предварительно заполняет значения следующих FileSystemInfo свойств:

• Attributes

• CreationTime

• CreationTimeUtc

• LastAccessTime

• LastAccessTimeUtc

• LastWriteTime

• LastWriteTimeUtc

Возвращаемая коллекция не кэшируется; Каждый вызов GetEnumerator метода в коллекции запустит новое перечисление.

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

• FileSystemWatcher

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

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

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

IEnumerable<FileSystemInfo>

Перечисляемая коллекция сведений об объектах файловой системы, соответствующая параметру searchPattern и enumerationOptions.

Исключения

ArgumentNullException

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

DirectoryNotFoundException

Путь, содержащийся в объекте DirectoryInfo , является недействительным (например, он ведет на несопоставленный диск).

SecurityException

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

Комментарии

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

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

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

Методы EnumerateFileSystemInfos и GetFileSystemInfos методы различаются следующим образом:

• При использовании EnumerateFileSystemInfosможно начать перечисление коллекции FileSystemInfo объектов перед возвратом всей коллекции.

• При использовании GetFileSystemInfosнеобходимо дождаться возвращения всего массива FileSystemInfo объектов, прежде чем получить доступ к массиву.

Таким образом, при работе с большим количеством файлов и каталогов EnumerateFileSystemInfos может быть более эффективным.

Этот метод предварительно заполняет значения следующих FileSystemInfo свойств:

• Attributes

• CreationTime

• CreationTimeUtc

• LastAccessTime

• LastAccessTimeUtc

• LastWriteTime

• LastWriteTimeUtc

Возвращаемая коллекция не кэшируется; Каждый вызов GetEnumerator метода в коллекции запустит новое перечисление.