DirectoryInfo.EnumerateFileSystemInfos Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Retorna uma coleção enumerável de informações do sistema de arquivos no diretório atual.

Sobrecargas

EnumerateFileSystemInfos(String, SearchOption)	Retorna uma coleção enumerável de informações do sistema de arquivos que corresponde a um padrão de pesquisa especificado e a uma opção de subdiretório de pesquisa.
EnumerateFileSystemInfos()	Retorna uma coleção enumerável de informações do sistema de arquivos no diretório atual.
EnumerateFileSystemInfos(String)	Retorna uma coleção enumerável de informações do sistema de arquivos que correspondem a um padrão de pesquisa especificado.
EnumerateFileSystemInfos(String, EnumerationOptions)	Retorna uma coleção enumerável de informações de arquivo que correspondem às opções especificadas de padrão de pesquisa e enumeração.

EnumerateFileSystemInfos(String, SearchOption)

Origem:

DirectoryInfo.cs

Retorna uma coleção enumerável de informações do sistema de arquivos que corresponde a um padrão de pesquisa especificado e a uma opção de subdiretório de pesquisa.

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)

Parâmetros

searchPattern

String

A cadeia de caracteres de pesquisa para correspondência em relação aos nomes dos diretórios. Esse parâmetro pode conter uma combinação de caracteres curinga (* e ?) e caminho de literal, mas não dá suporte a expressões regulares.

searchOption

SearchOption

Um dos valores de enumeração que especifica se a operação de pesquisa deve incluir somente o diretório atual ou todos os subdiretórios. O valor padrão é TopDirectoryOnly.

Retornos

IEnumerable<FileSystemInfo>

Uma coleção enumerável de objetos de informações do sistema de arquivos que corresponde a searchPattern e searchOption.

Exceções

ArgumentNullException

searchPattern é null.

ArgumentOutOfRangeException

searchOption não é um valor SearchOption válido.

DirectoryNotFoundException

O caminho encapsulado no objeto DirectoryInfo é inválido (por exemplo, está em uma unidade não mapeada).

SecurityException

O chamador não tem a permissão necessária.

Comentários

searchPattern pode ser uma combinação de caracteres literais e curinga, mas não dá suporte a expressões regulares. Os especificadores curinga a seguir são permitidos em searchPattern.

Especificador curinga	Corresponde a
* (asterisco)	Zero ou mais caracteres nessa posição.
? (ponto de interrogação)	Zero ou um caractere nessa posição.

Caracteres diferentes do curinga são caracteres literais. Por exemplo, a cadeia de caracteres "*t" pesquisa todos os nomes ao terminar com a letra "t". ". A searchPattern cadeia de caracteres "s*" procura todos os nomes no path início com a letra "s".

Os EnumerateFileSystemInfos métodos e GetFileSystemInfos diferem da seguinte maneira:

• Ao usar EnumerateFileSystemInfos, você pode começar a enumerar a coleção de FileSystemInfo objetos antes que toda a coleção seja retornada.

• Ao usar GetFileSystemInfos, você deve aguardar que toda a matriz de FileSystemInfo objetos seja retornada antes de poder acessar a matriz.

Portanto, quando você está trabalhando com muitos arquivos e diretórios, EnumerateFileSystemInfos pode ser mais eficiente.

Esse método preenche previamente os valores das seguintes FileSystemInfo propriedades:

• Attributes

• CreationTime

• CreationTimeUtc

• LastAccessTime

• LastAccessTimeUtc

• LastWriteTime

• LastWriteTimeUtc

A coleção retornada não é armazenada em cache; cada chamada para o GetEnumerator método na coleção iniciará uma nova enumeração.

Confira também

• FileSystemWatcher

EnumerateFileSystemInfos()

Origem:

DirectoryInfo.cs

Retorna uma coleção enumerável de informações do sistema de arquivos no diretório atual.

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)

Retornos

IEnumerable<FileSystemInfo>

Uma coleção enumerável de informações do sistema de arquivos no diretório atual.

Exceções

DirectoryNotFoundException

O caminho encapsulado no objeto DirectoryInfo é inválido (por exemplo, está em uma unidade não mapeada).

SecurityException

O chamador não tem a permissão necessária.

Comentários

Os EnumerateFileSystemInfos métodos e GetFileSystemInfos diferem da seguinte maneira:

• Ao usar EnumerateFileSystemInfos, você pode começar a enumerar a coleção de FileSystemInfo objetos antes que toda a coleção seja retornada.

• Ao usar GetFileSystemInfos, você deve aguardar que toda a matriz de FileSystemInfo objetos seja retornada antes de poder acessar a matriz.

Portanto, quando você está trabalhando com muitos arquivos e diretórios, EnumerateFileSystemInfos pode ser mais eficiente.

Esse método preenche previamente os valores das seguintes FileSystemInfo propriedades:

• Attributes

• CreationTime

• CreationTimeUtc

• LastAccessTime

• LastAccessTimeUtc

• LastWriteTime

• LastWriteTimeUtc

A coleção retornada não é armazenada em cache; cada chamada para o GetEnumerator método na coleção iniciará uma nova enumeração.

Confira também

• FileSystemWatcher

EnumerateFileSystemInfos(String)

Origem:

DirectoryInfo.cs

Retorna uma coleção enumerável de informações do sistema de arquivos que correspondem a um padrão de pesquisa especificado.

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)

Parâmetros

searchPattern

String

A cadeia de caracteres de pesquisa para correspondência em relação aos nomes dos diretórios. Esse parâmetro pode conter uma combinação de caracteres curinga (* e ?) e caminho de literal, mas não dá suporte a expressões regulares.

Retornos

IEnumerable<FileSystemInfo>

Uma coleção enumerável de objetos de informações do sistema de arquivos que corresponde a searchPattern.

Exceções

ArgumentNullException

searchPattern é null.

DirectoryNotFoundException

O caminho encapsulado no objeto DirectoryInfo é inválido (por exemplo, está em uma unidade não mapeada).

SecurityException

O chamador não tem a permissão necessária.

Comentários

searchPattern pode ser uma combinação de caracteres literais e curinga, mas não dá suporte a expressões regulares. Os especificadores curinga a seguir são permitidos em searchPattern.

Especificador curinga	Corresponde a
* (asterisco)	Zero ou mais caracteres nessa posição.
? (ponto de interrogação)	Zero ou um caractere nessa posição.

Caracteres diferentes do curinga são caracteres literais. Por exemplo, a cadeia de caracteres "*t" pesquisa todos os nomes ao terminar com a letra "t". ". A searchPattern cadeia de caracteres "s*" procura todos os nomes no path início com a letra "s".

Os EnumerateFileSystemInfos métodos e GetFileSystemInfos diferem da seguinte maneira:

• Ao usar EnumerateFileSystemInfos, você pode começar a enumerar a coleção de FileSystemInfo objetos antes que toda a coleção seja retornada.

• Ao usar GetFileSystemInfos, você deve aguardar que toda a matriz de FileSystemInfo objetos seja retornada antes de poder acessar a matriz.

Portanto, quando você está trabalhando com muitos arquivos e diretórios, EnumerateFileSystemInfos pode ser mais eficiente.

Esse método preenche previamente os valores das seguintes FileSystemInfo propriedades:

• Attributes

• CreationTime

• CreationTimeUtc

• LastAccessTime

• LastAccessTimeUtc

• LastWriteTime

• LastWriteTimeUtc

A coleção retornada não é armazenada em cache; cada chamada para o GetEnumerator método na coleção iniciará uma nova enumeração.

Confira também

• FileSystemWatcher

EnumerateFileSystemInfos(String, EnumerationOptions)

Origem:

DirectoryInfo.cs

Retorna uma coleção enumerável de informações de arquivo que correspondem às opções especificadas de padrão de pesquisa e enumeração.

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)

Parâmetros

searchPattern

String

A cadeia de caracteres de pesquisa para correspondência em relação aos nomes dos diretórios. Esse parâmetro pode conter uma combinação de caracteres curinga (* e ?) e caminho de literal, mas não dá suporte a expressões regulares.

enumerationOptions

EnumerationOptions

Um objeto que descreve a configuração de pesquisa e enumeração a ser usada.

Retornos

IEnumerable<FileSystemInfo>

Uma coleção enumerável de objetos de informações do sistema de arquivos que corresponde a searchPattern e enumerationOptions.

Exceções

ArgumentNullException

searchPattern é null.

DirectoryNotFoundException

O caminho encapsulado no objeto DirectoryInfo é inválido (por exemplo, está em uma unidade não mapeada).

SecurityException

O chamador não tem a permissão necessária.

Comentários

searchPattern pode ser uma combinação de caracteres literais e curinga, mas não dá suporte a expressões regulares. Os especificadores curinga a seguir são permitidos em searchPattern.

Especificador curinga	Corresponde a
* (asterisco)	Zero ou mais caracteres nessa posição.
? (ponto de interrogação)	Zero ou um caractere nessa posição.

Caracteres diferentes do curinga são caracteres literais. Por exemplo, a cadeia de caracteres "*t" pesquisa todos os nomes ao terminar com a letra "t". ". A searchPattern cadeia de caracteres "s*" procura todos os nomes no path início com a letra "s".

Os EnumerateFileSystemInfos métodos e GetFileSystemInfos diferem da seguinte maneira:

• Ao usar EnumerateFileSystemInfos, você pode começar a enumerar a coleção de FileSystemInfo objetos antes que toda a coleção seja retornada.

• Ao usar GetFileSystemInfos, você deve aguardar que toda a matriz de FileSystemInfo objetos seja retornada antes de poder acessar a matriz.

Portanto, quando você está trabalhando com muitos arquivos e diretórios, EnumerateFileSystemInfos pode ser mais eficiente.

Esse método preenche previamente os valores das seguintes FileSystemInfo propriedades:

• Attributes

• CreationTime

• CreationTimeUtc

• LastAccessTime

• LastAccessTimeUtc

• LastWriteTime

• LastWriteTimeUtc

A coleção retornada não é armazenada em cache; cada chamada para o GetEnumerator método na coleção iniciará uma nova enumeração.