DirectoryInfo.EnumerateFileSystemInfos Метод

Определение

Возвращает перечисляемую коллекцию сведений о файловой системе текущего каталога.Returns an enumerable collection of file system information in the current directory.

Перегрузки

EnumerateFileSystemInfos(String, SearchOption)

Возвращает перечисляемую коллекцию сведений о файловой системе, соответствующую указанному шаблону поиска и параметру поиска в подкаталогах.Returns an enumerable collection of file system information that matches a specified search pattern and search subdirectory option.

EnumerateFileSystemInfos()

Возвращает перечисляемую коллекцию сведений о файловой системе текущего каталога.Returns an enumerable collection of file system information in the current directory.

EnumerateFileSystemInfos(String)

Возвращает перечисляемую коллекцию сведений о файловой системе, соответствующую указанному шаблону поиска.Returns an enumerable collection of file system information that matches a specified search pattern.

EnumerateFileSystemInfos(String, EnumerationOptions)

Возвращает перечисляемую коллекцию сведений о файловой системе, соответствующую указанному шаблону поиска и параметрам перечисления.Returns an enumerable collection of file system information that matches the specified search pattern and enumeration options.

EnumerateFileSystemInfos(String, SearchOption)

Возвращает перечисляемую коллекцию сведений о файловой системе, соответствующую указанному шаблону поиска и параметру поиска в подкаталогах.Returns an enumerable collection of file system information that matches a specified search pattern and search subdirectory option.

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

Строка поиска, которая будет сравниваться с именами каталогов.The search string to match against the names of directories. Этот параметр может содержать сочетание допустимого литерального пути и подстановочного символа (* и ?), но не поддерживает регулярные выражения.This parameter can contain a combination of valid literal path and wildcard (* and ?) characters, but it doesn't support regular expressions.

searchOption
SearchOption

Одно из значений перечисления, определяющее, следует ли выполнять поиск только в текущем каталоге или также во всех его подкаталогах.One of the enumeration values that specifies whether the search operation should include only the current directory or all subdirectories. Значение по умолчанию — TopDirectoryOnly.The default value is TopDirectoryOnly.

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

IEnumerable<FileSystemInfo>

Перечисляемая коллекция сведений об объектах файловой системы, соответствующая параметру searchPattern и searchOption.An enumerable collection of file system information objects that matches searchPattern and searchOption.

Исключения

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

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

Путь, содержащийся в объекте DirectoryInfo , является недействительным (например, он ведет на несопоставленный диск).The path encapsulated in the DirectoryInfo object is invalid (for example, it is on an unmapped drive).

У вызывающего объекта отсутствует необходимое разрешение.The caller does not have the required permission.

Комментарии

searchPattern может быть сочетанием литеральных символов и подстановочных знаков, но не поддерживает регулярные выражения.searchPattern can be a combination of literal and wildcard characters, but it doesn't support regular expressions. В могут быть использованы следующие подстановочные знаки searchPattern .The following wildcard specifiers are permitted in searchPattern.

Спецификатор подстановочного знакаWildcard specifier СоответствуетMatches
* ** (asterisk) Ноль или более символов в этой должности.Zero or more characters in that position.
?? (вопросительный знак)(question mark) Ноль или один символ в этой позиции.Zero or one character in that position.

Символы, отличные от подстановочных знаков, являются литеральными символами.Characters other than the wildcard are literal characters. Например, строка « * t» ищет все имена в конце буквы «t».For example, the string "*t" searches for all names in ending with the letter "t". ".". searchPatternСтрока "s * " ищет все имена в path начале с буквой "s".The searchPattern string "s*" searches for all names in path beginning with the letter "s".

EnumerateFileSystemInfosМетоды и GetFileSystemInfos различаются следующим образом.The EnumerateFileSystemInfos and GetFileSystemInfos methods differ as follows:

  • При использовании EnumerateFileSystemInfos можно начать перечисление коллекции объектов до того, FileSystemInfo как будет возвращена вся коллекция.When you use EnumerateFileSystemInfos, you can start enumerating the collection of FileSystemInfo objects before the whole collection is returned.

  • При использовании необходимо GetFileSystemInfos дождаться возврата всего массива FileSystemInfo объектов, прежде чем можно будет получить доступ к массиву.When you use GetFileSystemInfos, you must wait for the whole array of FileSystemInfo objects to be returned before you can access the array.

Поэтому при работе с множеством файлов и каталогов EnumerateFileSystemInfos может быть более эффективным.Therefore, when you are working with many files and directories, EnumerateFileSystemInfos can be more efficient.

Этот метод предварительно заполняет значения следующих FileSystemInfo свойств:This method pre-populates the values of the following FileSystemInfo properties:

Возвращенная коллекция не кэшируется; при каждом вызове GetEnumerator метода в коллекции будет запущено новое перечисление.The returned collection is not cached; each call to the GetEnumerator method on the collection will start a new enumeration.

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

Применяется к

EnumerateFileSystemInfos()

Возвращает перечисляемую коллекцию сведений о файловой системе текущего каталога.Returns an enumerable collection of file system information in the current directory.

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>

Перечисляемая коллекция сведений о файловой системе текущего каталога.An enumerable collection of file system information in the current directory.

Исключения

Путь, содержащийся в объекте DirectoryInfo , является недействительным (например, он ведет на несопоставленный диск).The path encapsulated in the DirectoryInfo object is invalid (for example, it is on an unmapped drive).

У вызывающего объекта отсутствует необходимое разрешение.The caller does not have the required permission.

Комментарии

EnumerateFileSystemInfosМетоды и GetFileSystemInfos различаются следующим образом.The EnumerateFileSystemInfos and GetFileSystemInfos methods differ as follows:

  • При использовании EnumerateFileSystemInfos можно начать перечисление коллекции объектов до того, FileSystemInfo как будет возвращена вся коллекция.When you use EnumerateFileSystemInfos, you can start enumerating the collection of FileSystemInfo objects before the whole collection is returned.

  • При использовании необходимо GetFileSystemInfos дождаться возврата всего массива FileSystemInfo объектов, прежде чем можно будет получить доступ к массиву.When you use GetFileSystemInfos, you must wait for the whole array of FileSystemInfo objects to be returned before you can access the array.

Поэтому при работе с множеством файлов и каталогов EnumerateFileSystemInfos может быть более эффективным.Therefore, when you are working with many files and directories, EnumerateFileSystemInfos can be more efficient.

Этот метод предварительно заполняет значения следующих FileSystemInfo свойств:This method pre-populates the values of the following FileSystemInfo properties:

Возвращенная коллекция не кэшируется; при каждом вызове GetEnumerator метода в коллекции будет запущено новое перечисление.The returned collection is not cached; each call to the GetEnumerator method on the collection will start a new enumeration.

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

Применяется к

EnumerateFileSystemInfos(String)

Возвращает перечисляемую коллекцию сведений о файловой системе, соответствующую указанному шаблону поиска.Returns an enumerable collection of file system information that matches a specified search pattern.

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

Строка поиска, которая будет сравниваться с именами каталогов.The search string to match against the names of directories. Этот параметр может содержать сочетание допустимого литерального пути и подстановочного символа (* и ?), но не поддерживает регулярные выражения.This parameter can contain a combination of valid literal path and wildcard (* and ?) characters, but it doesn't support regular expressions.

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

IEnumerable<FileSystemInfo>

Перечисляемая коллекция сведений об объектах файловой системы, соответствующая параметру searchPattern.An enumerable collection of file system information objects that matches searchPattern.

Исключения

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

Путь, содержащийся в объекте DirectoryInfo , является недействительным (например, он ведет на несопоставленный диск).The path encapsulated in the DirectoryInfo object is invalid (for example, it is on an unmapped drive).

У вызывающего объекта отсутствует необходимое разрешение.The caller does not have the required permission.

Комментарии

searchPattern может быть сочетанием литеральных символов и подстановочных знаков, но не поддерживает регулярные выражения.searchPattern can be a combination of literal and wildcard characters, but it doesn't support regular expressions. В могут быть использованы следующие подстановочные знаки searchPattern .The following wildcard specifiers are permitted in searchPattern.

Спецификатор подстановочного знакаWildcard specifier СоответствуетMatches
* ** (asterisk) Ноль или более символов в этой должности.Zero or more characters in that position.
?? (вопросительный знак)(question mark) Ноль или один символ в этой позиции.Zero or one character in that position.

Символы, отличные от подстановочных знаков, являются литеральными символами.Characters other than the wildcard are literal characters. Например, строка « * t» ищет все имена в конце буквы «t».For example, the string "*t" searches for all names in ending with the letter "t". ".". searchPatternСтрока "s * " ищет все имена в path начале с буквой "s".The searchPattern string "s*" searches for all names in path beginning with the letter "s".

EnumerateFileSystemInfosМетоды и GetFileSystemInfos различаются следующим образом.The EnumerateFileSystemInfos and GetFileSystemInfos methods differ as follows:

  • При использовании EnumerateFileSystemInfos можно начать перечисление коллекции объектов до того, FileSystemInfo как будет возвращена вся коллекция.When you use EnumerateFileSystemInfos, you can start enumerating the collection of FileSystemInfo objects before the whole collection is returned.

  • При использовании необходимо GetFileSystemInfos дождаться возврата всего массива FileSystemInfo объектов, прежде чем можно будет получить доступ к массиву.When you use GetFileSystemInfos, you must wait for the whole array of FileSystemInfo objects to be returned before you can access the array.

Поэтому при работе с множеством файлов и каталогов EnumerateFileSystemInfos может быть более эффективным.Therefore, when you are working with many files and directories, EnumerateFileSystemInfos can be more efficient.

Этот метод предварительно заполняет значения следующих FileSystemInfo свойств:This method pre-populates the values of the following FileSystemInfo properties:

Возвращенная коллекция не кэшируется; при каждом вызове GetEnumerator метода в коллекции будет запущено новое перечисление.The returned collection is not cached; each call to the GetEnumerator method on the collection will start a new enumeration.

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

Применяется к

EnumerateFileSystemInfos(String, EnumerationOptions)

Возвращает перечисляемую коллекцию сведений о файловой системе, соответствующую указанному шаблону поиска и параметрам перечисления.Returns an enumerable collection of file system information that matches the specified search pattern and enumeration options.

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

Строка поиска, которая будет сравниваться с именами каталогов.The search string to match against the names of directories. Этот параметр может содержать сочетание допустимого литерального пути и подстановочного символа (* и ?), но не поддерживает регулярные выражения.This parameter can contain a combination of valid literal path and wildcard (* and ?) characters, but it doesn't support regular expressions.

enumerationOptions
EnumerationOptions

Объект, описывающий конфигурацию поиска и перечисления для использования.An object that describes the search and enumeration configuration to use.

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

IEnumerable<FileSystemInfo>

Перечисляемая коллекция сведений об объектах файловой системы, соответствующая параметру searchPattern и enumerationOptions.An enumerable collection of file system information objects that matches searchPattern and enumerationOptions.

Исключения

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

Путь, содержащийся в объекте DirectoryInfo , является недействительным (например, он ведет на несопоставленный диск).The path encapsulated in the DirectoryInfo object is invalid (for example, it is on an unmapped drive).

У вызывающего объекта отсутствует необходимое разрешение.The caller does not have the required permission.

Комментарии

searchPattern может быть сочетанием литеральных символов и подстановочных знаков, но не поддерживает регулярные выражения.searchPattern can be a combination of literal and wildcard characters, but it doesn't support regular expressions. В могут быть использованы следующие подстановочные знаки searchPattern .The following wildcard specifiers are permitted in searchPattern.

Спецификатор подстановочного знакаWildcard specifier СоответствуетMatches
* ** (asterisk) Ноль или более символов в этой должности.Zero or more characters in that position.
?? (вопросительный знак)(question mark) Ноль или один символ в этой позиции.Zero or one character in that position.

Символы, отличные от подстановочных знаков, являются литеральными символами.Characters other than the wildcard are literal characters. Например, строка « * t» ищет все имена в конце буквы «t».For example, the string "*t" searches for all names in ending with the letter "t". ".". searchPatternСтрока "s * " ищет все имена в path начале с буквой "s".The searchPattern string "s*" searches for all names in path beginning with the letter "s".

EnumerateFileSystemInfosМетоды и GetFileSystemInfos различаются следующим образом.The EnumerateFileSystemInfos and GetFileSystemInfos methods differ as follows:

  • При использовании EnumerateFileSystemInfos можно начать перечисление коллекции объектов до того, FileSystemInfo как будет возвращена вся коллекция.When you use EnumerateFileSystemInfos, you can start enumerating the collection of FileSystemInfo objects before the whole collection is returned.

  • При использовании необходимо GetFileSystemInfos дождаться возврата всего массива FileSystemInfo объектов, прежде чем можно будет получить доступ к массиву.When you use GetFileSystemInfos, you must wait for the whole array of FileSystemInfo objects to be returned before you can access the array.

Поэтому при работе с множеством файлов и каталогов EnumerateFileSystemInfos может быть более эффективным.Therefore, when you are working with many files and directories, EnumerateFileSystemInfos can be more efficient.

Этот метод предварительно заполняет значения следующих FileSystemInfo свойств:This method pre-populates the values of the following FileSystemInfo properties:

Возвращенная коллекция не кэшируется; при каждом вызове GetEnumerator метода в коллекции будет запущено новое перечисление.The returned collection is not cached; each call to the GetEnumerator method on the collection will start a new enumeration.

Применяется к