DirectoryInfo.EnumerateFileSystemInfos Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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)
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
Uma coleção enumerável de objetos de informações do sistema de arquivos que corresponde a searchPattern e searchOption.
Exceções
searchPattern é null.
searchOption não é um valor SearchOption válido.
O caminho encapsulado no objeto DirectoryInfo é inválido (por exemplo, está em uma unidade não mapeada).
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 oferece suporte a expressões regulares. Os especificadores curinga a seguir são permitidos no searchPattern .
| Especificador de 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" procura todos os nomes que terminam com a letra "t". ". A searchPattern cadeia de caracteres "s * " pesquisa todos os nomes no path início com a letra "s".
Os EnumerateFileSystemInfos GetFileSystemInfos métodos e são diferentes da seguinte maneira:
Ao usar EnumerateFileSystemInfos o, você pode iniciar a enumeração da coleção de FileSystemInfo objetos antes que toda a coleção seja retornada.
Ao usar o GetFileSystemInfos , você deve aguardar a matriz inteira de FileSystemInfo objetos a ser retornada antes de poder acessar a matriz.
Portanto, quando você estiver trabalhando com muitos arquivos e diretórios, o EnumerateFileSystemInfos poderá ser mais eficiente.
Esse método popula previamente os valores das seguintes FileSystemInfo Propriedades:
A coleção retornada não está armazenada em cache; cada chamada para o GetEnumerator método na coleção iniciará uma nova enumeração.
Confira também
Aplica-se a
EnumerateFileSystemInfos()
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
Uma coleção enumerável de informações do sistema de arquivos no diretório atual.
Exceções
O caminho encapsulado no objeto DirectoryInfo é inválido (por exemplo, está em uma unidade não mapeada).
O chamador não tem a permissão necessária.
Comentários
Os EnumerateFileSystemInfos métodos GetFileSystemInfos e diferem da seguinte forma:
Ao usar EnumerateFileSystemInfos , você pode começar a enumerar a coleção de objetos antes que toda a coleção seja FileSystemInfo retornada.
Ao usar , você deve aguardar até que toda a matriz de objetos GetFileSystemInfos FileSystemInfo 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:
A coleção retornada não é armazenada em cache; cada chamada para GetEnumerator o método na coleção iniciará uma nova enumeração.
Confira também
Aplica-se a
EnumerateFileSystemInfos(String)
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
Uma coleção enumerável de objetos de informações do sistema de arquivos que corresponde a searchPattern.
Exceções
searchPattern é null.
O caminho encapsulado no objeto DirectoryInfo é inválido (por exemplo, está em uma unidade não mapeada).
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 de curinga a seguir são permitidos em searchPattern .
| Especificador de 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 que terminam com a letra "t". ". A searchPattern cadeia de * caracteres "s" pesquisa todos os nomes path no início com a letra "s".
Os EnumerateFileSystemInfos métodos GetFileSystemInfos e diferem da seguinte forma:
Ao usar EnumerateFileSystemInfos , você pode começar a enumerar a coleção de objetos antes que toda a coleção seja FileSystemInfo retornada.
Ao usar , você deve aguardar até que toda a matriz de objetos GetFileSystemInfos FileSystemInfo 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:
A coleção retornada não é armazenada em cache; cada chamada para GetEnumerator o método na coleção iniciará uma nova enumeração.
Confira também
Aplica-se a
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.
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
Uma coleção enumerável de objetos de informações do sistema de arquivos que corresponde a searchPattern e enumerationOptions.
Exceções
searchPattern é null.
O caminho encapsulado no objeto DirectoryInfo é inválido (por exemplo, está em uma unidade não mapeada).
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 de curinga a seguir são permitidos em searchPattern .
| Especificador de 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 que terminam com a letra "t". ". A searchPattern cadeia de * caracteres "s" pesquisa todos os nomes path no início com a letra "s".
Os EnumerateFileSystemInfos métodos GetFileSystemInfos e diferem da seguinte forma:
Ao usar EnumerateFileSystemInfos , você pode começar a enumerar a coleção de objetos antes que toda a coleção seja FileSystemInfo retornada.
Ao usar , você deve aguardar até que toda a matriz de objetos GetFileSystemInfos FileSystemInfo 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:
A coleção retornada não é armazenada em cache; cada chamada para GetEnumerator o método na coleção iniciará uma nova enumeração.