Directory.EnumerateFileSystemEntries 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 entradas do sistema de arquivos que atendem aos critérios especificados.
Sobrecargas
| Nome | Description |
|---|---|
| EnumerateFileSystemEntries(String) |
Retorna uma coleção enumerável de nomes de arquivo e nomes de diretório em um caminho especificado. |
| EnumerateFileSystemEntries(String, String) |
Retorna uma coleção enumerável de nomes de arquivo e nomes de diretório que correspondem a um padrão de pesquisa em um caminho especificado. |
| EnumerateFileSystemEntries(String, String, EnumerationOptions) |
Retorna uma coleção enumerável de nomes de arquivo e nomes de diretório que correspondem a um padrão de pesquisa e opções de enumeração em um caminho especificado. |
| EnumerateFileSystemEntries(String, String, SearchOption) |
Retorna uma coleção enumerável de nomes de arquivo e nomes de diretório que correspondem a um padrão de pesquisa em um caminho especificado e, opcionalmente, pesquisa subdiretórios. |
EnumerateFileSystemEntries(String)
- Origem:
- Directory.cs
- Origem:
- Directory.cs
- Origem:
- Directory.cs
- Origem:
- Directory.cs
- Origem:
- Directory.cs
Retorna uma coleção enumerável de nomes de arquivo e nomes de diretório em um caminho especificado.
public:
static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path);public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries(string path);static member EnumerateFileSystemEntries : string -> seq<string>Public Shared Function EnumerateFileSystemEntries (path As String) As IEnumerable(Of String)Parâmetros
- path
- String
O caminho relativo ou absoluto para o diretório a ser pesquisado. Essa cadeia de caracteres não diferencia maiúsculas de minúsculas.
Retornos
Uma coleção enumerável de entradas do sistema de arquivos no diretório especificado por path.
Exceções
.NET Framework e .NET Core versões anteriores à 2.1: path é uma cadeia de caracteres de comprimento zero, contém apenas espaço em branco ou contém caracteres inválidos. Você pode consultar caracteres inválidos usando o GetInvalidPathChars() método.
path é null.
path é inválido, como fazer referência a uma unidade não mapeada.
path é um nome de arquivo.
O caminho, o nome do arquivo ou combinado especificado excedem o comprimento máximo definido pelo sistema.
O chamador não tem a permissão necessária.
O chamador não tem a permissão necessária.
Comentários
Você pode especificar informações de caminho relativo com o path parâmetro. As informações de caminho relativo são interpretadas como relativas ao diretório de trabalho atual, que você pode determinar usando o GetCurrentDirectory método.
Os EnumerateFileSystemEntries métodos e GetFileSystemEntries os métodos diferem da seguinte maneira: quando você usa EnumerateFileSystemEntries, você pode começar a enumerar a coleção de entradas antes que toda a coleção seja retornada; quando você usar GetFileSystemEntries, deverá aguardar que toda a matriz de entradas seja retornada antes de poder acessar a matriz. Portanto, quando você está trabalhando com muitos arquivos e diretórios, EnumerateFileSystemEntries pode ser mais eficiente.
A coleção retornada não é armazenada em cache; cada chamada para a GetEnumerator coleção iniciará uma nova enumeração.
Aplica-se a
EnumerateFileSystemEntries(String, String)
- Origem:
- Directory.cs
- Origem:
- Directory.cs
- Origem:
- Directory.cs
- Origem:
- Directory.cs
- Origem:
- Directory.cs
Retorna uma coleção enumerável de nomes de arquivo e nomes de diretório que correspondem a um padrão de pesquisa em um caminho especificado.
public:
static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path, System::String ^ searchPattern);public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries(string path, string searchPattern);static member EnumerateFileSystemEntries : string * string -> seq<string>Public Shared Function EnumerateFileSystemEntries (path As String, searchPattern As String) As IEnumerable(Of String)Parâmetros
- path
- String
O caminho relativo ou absoluto para o diretório a ser pesquisado. Essa cadeia de caracteres não diferencia maiúsculas de minúsculas.
- searchPattern
- String
A cadeia de caracteres de pesquisa a ser correspondida com os nomes das entradas do sistema de arquivos em path. Esse parâmetro pode conter uma combinação de caracteres de caminho literal válido e curinga (* e ?), mas não dá suporte a expressões regulares.
Retornos
Uma coleção enumerável de entradas do sistema de arquivos no diretório especificado path e que corresponde ao padrão de pesquisa especificado.
Exceções
.NET Framework e .NET Core versões anteriores à 2.1: path é uma cadeia de caracteres de comprimento zero, contém apenas espaço em branco ou contém caracteres inválidos. Você pode consultar caracteres inválidos usando o GetInvalidPathChars() método.
- ou -
searchPattern não contém um padrão válido.
path é inválido, como fazer referência a uma unidade não mapeada.
path é um nome de arquivo.
O caminho, o nome do arquivo ou combinado especificado excedem o comprimento máximo definido pelo sistema.
O chamador não tem a permissão necessária.
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 | Partidas |
|---|---|
| * (asterisco) | Zero ou mais caracteres nessa posição. |
| ? (ponto de interrogação) | Exatamente um caractere nessa posição. |
Caracteres diferentes do curinga são caracteres literais. Por exemplo, a searchPattern cadeia de caracteres "*t" pesquisa todos os nomes ao path terminar com a letra "t". A searchPattern cadeia de caracteres "s*" pesquisa todos os nomes no path início com a letra "s".
Note
Quando você usa o caractere curinga do asterisco em um searchPattern caractere curinga como "*.txt", o número de caracteres na extensão especificada afeta a pesquisa da seguinte maneira:
- Se a extensão especificada tiver exatamente três caracteres, o método retornará arquivos com extensões que começam com a extensão especificada. Por exemplo, "*.xls" retorna "book.xls" e "book.xlsx".
- Em todos os outros casos, o método retorna arquivos que correspondem exatamente à extensão especificada. Por exemplo, "*.ai" retorna "file.ai", mas não "file.aif".
Quando você usa o caractere curinga de ponto de interrogação, esse método retorna apenas arquivos que correspondem à extensão de arquivo especificada. Por exemplo, dado dois arquivos, "file1.txt" e "file1.txtother", em um diretório, um padrão de pesquisa de "arquivo?.txt" retorna apenas o primeiro arquivo, enquanto um padrão de pesquisa de "file*.txt" retorna ambos os arquivos.
searchPattern não pode terminar em dois períodos ("..") ou conter dois períodos ("..") seguidos ou DirectorySeparatorCharAltDirectorySeparatorChar, nem pode conter caracteres inválidos. Você pode consultar caracteres inválidos usando o GetInvalidPathChars método.
Você pode especificar informações de caminho relativo com o path parâmetro. As informações de caminho relativo são interpretadas como relativas ao diretório de trabalho atual, que você pode determinar usando o GetCurrentDirectory método.
Os EnumerateFileSystemEntries métodos e GetFileSystemEntries os métodos diferem da seguinte maneira: quando você usa EnumerateFileSystemEntries, você pode começar a enumerar a coleção de entradas antes que toda a coleção seja retornada; quando você usar GetFileSystemEntries, deverá aguardar que toda a matriz de entradas seja retornada antes de poder acessar a matriz. Portanto, quando você está trabalhando com muitos arquivos e diretórios, EnumerateFileSystemEntries pode ser mais eficiente.
A coleção retornada não é armazenada em cache; cada chamada para a GetEnumerator coleção iniciará uma nova enumeração.
Aplica-se a
EnumerateFileSystemEntries(String, String, EnumerationOptions)
- Origem:
- Directory.cs
- Origem:
- Directory.cs
- Origem:
- Directory.cs
- Origem:
- Directory.cs
- Origem:
- Directory.cs
Retorna uma coleção enumerável de nomes de arquivo e nomes de diretório que correspondem a um padrão de pesquisa e opções de enumeração em um caminho especificado.
public:
static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path, System::String ^ searchPattern, System::IO::EnumerationOptions ^ enumerationOptions);public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries(string path, string searchPattern, System.IO.EnumerationOptions enumerationOptions);static member EnumerateFileSystemEntries : string * string * System.IO.EnumerationOptions -> seq<string>Public Shared Function EnumerateFileSystemEntries (path As String, searchPattern As String, enumerationOptions As EnumerationOptions) As IEnumerable(Of String)Parâmetros
- path
- String
O caminho relativo ou absoluto para o diretório a ser pesquisado. Essa cadeia de caracteres não diferencia maiúsculas de minúsculas.
- searchPattern
- String
A cadeia de caracteres de pesquisa a ser correspondida com os nomes de arquivos e diretórios em path. Esse parâmetro pode conter uma combinação de caracteres literais e curinga válidos, 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 entradas do sistema de arquivos no diretório especificado por path, que corresponde ao padrão de pesquisa especificado e às opções de enumeração especificadas.
Exceções
.NET Framework e .NET Core versões anteriores à 2.1: path é uma cadeia de caracteres de comprimento zero, contém apenas espaço em branco ou contém caracteres inválidos. Você pode consultar caracteres inválidos usando o GetInvalidPathChars() método.
- ou -
searchPattern não contém um padrão válido.
path é inválido, como fazer referência a uma unidade não mapeada.
path é um nome de arquivo.
O caminho, o nome do arquivo ou combinado especificado excedem o comprimento máximo definido pelo sistema.
O chamador não tem a permissão necessária.
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 | Partidas |
|---|---|
| * (asterisco) | Zero ou mais caracteres nessa posição. |
| ? (ponto de interrogação) | Exatamente um caractere nessa posição. |
Caracteres diferentes do curinga são caracteres literais. Por exemplo, a searchPattern cadeia de caracteres "*t" pesquisa todos os nomes ao path terminar com a letra "t". A searchPattern cadeia de caracteres "s*" pesquisa todos os nomes no path início com a letra "s".
Note
Quando você usa o caractere curinga do asterisco em um searchPattern caractere curinga como "*.txt", o número de caracteres na extensão especificada afeta a pesquisa da seguinte maneira:
- Se a extensão especificada tiver exatamente três caracteres, o método retornará arquivos com extensões que começam com a extensão especificada. Por exemplo, "*.xls" retorna "book.xls" e "book.xlsx".
- Em todos os outros casos, o método retorna arquivos que correspondem exatamente à extensão especificada. Por exemplo, "*.ai" retorna "file.ai", mas não "file.aif".
Quando você usa o caractere curinga de ponto de interrogação, esse método retorna apenas arquivos que correspondem à extensão de arquivo especificada. Por exemplo, dado dois arquivos, "file1.txt" e "file1.txtother", em um diretório, um padrão de pesquisa de "arquivo?.txt" retorna apenas o primeiro arquivo, enquanto um padrão de pesquisa de "file*.txt" retorna ambos os arquivos.
searchPattern não pode terminar em dois períodos ("..") ou conter dois períodos ("..") seguidos ou DirectorySeparatorCharAltDirectorySeparatorChar, nem pode conter caracteres inválidos. Você pode consultar caracteres inválidos usando o GetInvalidPathChars método.
Você pode especificar informações de caminho relativo com o path parâmetro. As informações de caminho relativo são interpretadas como relativas ao diretório de trabalho atual, que você pode determinar usando o GetCurrentDirectory método.
Os EnumerateFileSystemEntries métodos e GetFileSystemEntries os métodos diferem da seguinte maneira: quando você usa EnumerateFileSystemEntries, você pode começar a enumerar a coleção de entradas antes que toda a coleção seja retornada; quando você usar GetFileSystemEntries, deverá aguardar que toda a matriz de entradas seja retornada antes de poder acessar a matriz. Portanto, quando você está trabalhando com muitos arquivos e diretórios, EnumerateFileSystemEntries pode ser mais eficiente.
A coleção retornada não é armazenada em cache; cada chamada para a GetEnumerator coleção iniciará uma nova enumeração.
Aplica-se a
EnumerateFileSystemEntries(String, String, SearchOption)
- Origem:
- Directory.cs
- Origem:
- Directory.cs
- Origem:
- Directory.cs
- Origem:
- Directory.cs
- Origem:
- Directory.cs
Retorna uma coleção enumerável de nomes de arquivo e nomes de diretório que correspondem a um padrão de pesquisa em um caminho especificado e, opcionalmente, pesquisa subdiretórios.
public:
static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path, System::String ^ searchPattern, System::IO::SearchOption searchOption);public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries(string path, string searchPattern, System.IO.SearchOption searchOption);static member EnumerateFileSystemEntries : string * string * System.IO.SearchOption -> seq<string>Public Shared Function EnumerateFileSystemEntries (path As String, searchPattern As String, searchOption As SearchOption) As IEnumerable(Of String)Parâmetros
- path
- String
O caminho relativo ou absoluto para o diretório a ser pesquisado. Essa cadeia de caracteres não diferencia maiúsculas de minúsculas.
- searchPattern
- String
A cadeia de caracteres de pesquisa a ser correspondente às entradas do sistema de arquivos em path. Esse parâmetro pode conter uma combinação de caracteres de caminho literal válido e curinga (* e ?), 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 apenas o diretório atual ou deve incluir todos os subdiretórios. O valor padrão é TopDirectoryOnly.
Retornos
Uma coleção enumerável de entradas do sistema de arquivos no diretório especificado path e que corresponde ao padrão e à opção de pesquisa especificados.
Exceções
.NET Framework e .NET Core versões anteriores à 2.1: path é uma cadeia de caracteres de comprimento zero, contém apenas espaço em branco ou contém caracteres inválidos. Você pode consultar caracteres inválidos usando o GetInvalidPathChars() método.
- ou -
searchPattern não contém um padrão válido.
searchOption não é um valor válido SearchOption .
path é inválido, como fazer referência a uma unidade não mapeada.
path é um nome de arquivo.
O caminho, o nome do arquivo ou combinado especificado excedem o comprimento máximo definido pelo sistema.
O chamador não tem a permissão necessária.
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 | Partidas |
|---|---|
| * (asterisco) | Zero ou mais caracteres nessa posição. |
| ? (ponto de interrogação) | Exatamente um caractere nessa posição. |
Caracteres diferentes do curinga são caracteres literais. Por exemplo, a searchPattern cadeia de caracteres "*t" pesquisa todos os nomes ao path terminar com a letra "t". A searchPattern cadeia de caracteres "s*" pesquisa todos os nomes no path início com a letra "s".
Note
Quando você usa o caractere curinga do asterisco em um searchPattern caractere curinga como "*.txt", o número de caracteres na extensão especificada afeta a pesquisa da seguinte maneira:
- Se a extensão especificada tiver exatamente três caracteres, o método retornará arquivos com extensões que começam com a extensão especificada. Por exemplo, "*.xls" retorna "book.xls" e "book.xlsx".
- Em todos os outros casos, o método retorna arquivos que correspondem exatamente à extensão especificada. Por exemplo, "*.ai" retorna "file.ai", mas não "file.aif".
Quando você usa o caractere curinga de ponto de interrogação, esse método retorna apenas arquivos que correspondem à extensão de arquivo especificada. Por exemplo, dado dois arquivos, "file1.txt" e "file1.txtother", em um diretório, um padrão de pesquisa de "arquivo?.txt" retorna apenas o primeiro arquivo, enquanto um padrão de pesquisa de "file*.txt" retorna ambos os arquivos.
searchPattern não pode terminar em dois períodos ("..") ou conter dois períodos ("..") seguidos ou DirectorySeparatorCharAltDirectorySeparatorChar, nem pode conter caracteres inválidos. Você pode consultar caracteres inválidos usando o GetInvalidPathChars método.
Você pode especificar informações de caminho relativo com o path parâmetro. As informações de caminho relativo são interpretadas como relativas ao diretório de trabalho atual, que você pode determinar usando o GetCurrentDirectory método.
Os EnumerateFileSystemEntries métodos e GetFileSystemEntries os métodos diferem da seguinte maneira: quando você usa EnumerateFileSystemEntries, você pode começar a enumerar a coleção de entradas antes que toda a coleção seja retornada; quando você usar GetFileSystemEntries, deverá aguardar que toda a matriz de entradas seja retornada antes de poder acessar a matriz. Portanto, quando você está trabalhando com muitos arquivos e diretórios, EnumerateFileSystemEntries pode ser mais eficiente.
A coleção retornada não é armazenada em cache; cada chamada para a GetEnumerator coleção iniciará uma nova enumeração.
