Directory.EnumerateFileSystemEntries Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Devolve uma coleção enumerável de entradas do sistema de ficheiros que cumprem critérios especificados.
Sobrecargas
| Name | Description |
|---|---|
| EnumerateFileSystemEntries(String) |
Devolve uma coleção enumerável de nomes de ficheiros e nomes de diretórios num caminho especificado. |
| EnumerateFileSystemEntries(String, String) |
Devolve uma coleção enumerável de nomes de ficheiros e nomes de diretórios que correspondem a um padrão de pesquisa num caminho especificado. |
| EnumerateFileSystemEntries(String, String, EnumerationOptions) |
Devolve uma coleção enumerável de nomes de ficheiros e diretórios que correspondem a um padrão de pesquisa e opções de enumeração num caminho especificado. |
| EnumerateFileSystemEntries(String, String, SearchOption) |
Devolve uma coleção enumerável de nomes de ficheiros e nomes de diretórios que correspondem a um padrão de pesquisa num caminho especificado, e opcionalmente pesquisa em subdiretórios. |
EnumerateFileSystemEntries(String)
- Origem:
- Directory.cs
- Origem:
- Directory.cs
- Origem:
- Directory.cs
- Origem:
- Directory.cs
- Origem:
- Directory.cs
Devolve uma coleção enumerável de nomes de ficheiros e nomes de diretórios num 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 pesquisar. Esta cadeia não é sensível a maiúsculas minúsculas.
Devoluções
Uma coleção enumerável de entradas do sistema de ficheiros no diretório especificado por path.
Exceções
.NET Framework e .NET Core versões anteriores à 2.1: path é uma string de comprimento zero, contém apenas espaço em branco ou contém caracteres inválidos. Pode consultar caracteres inválidos usando o GetInvalidPathChars() método.
path é null.
path é inválido, como referir-se a um disco não mapeado.
path é um nome de ficheiro.
O caminho, nome do ficheiro ou combinação especificados excedem o comprimento máximo definido pelo sistema.
O interlocutor não tem a permissão necessária.
O interlocutor não tem a permissão necessária.
Observações
Pode especificar a informação relativa do caminho com o path parâmetro. A informação relativa do caminho é interpretada como relativa ao diretório de trabalho atual, que pode determinar usando o GetCurrentDirectory método.
Os EnumerateFileSystemEntries métodos e GetFileSystemEntries diferem da seguinte forma: Quando usa EnumerateFileSystemEntries, pode começar a enumerar a coleção de entradas antes que toda a coleção seja devolvida; quando usa GetFileSystemEntries, deve esperar que todo o array de entradas seja devolvido antes de poder aceder ao array. Por isso, quando trabalha com muitos ficheiros e diretórios, EnumerateFileSystemEntries pode ser mais eficiente.
A coleção devolvida não é armazenada em cache; Cada chamada à 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
Devolve uma coleção enumerável de nomes de ficheiros e nomes de diretórios que correspondem a um padrão de pesquisa num 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 pesquisar. Esta cadeia não é sensível a maiúsculas minúsculas.
- searchPattern
- String
A cadeia de pesquisa para comparar com os nomes das entradas do sistema de ficheiros em path. Este parâmetro pode conter uma combinação de caracteres válidos de path literais e wildcard (* e ?), mas não suporta expressões regulares.
Devoluções
Uma coleção enumerável de entradas do sistema de ficheiros no diretório especificado por path e que correspondem ao padrão de pesquisa especificado.
Exceções
.NET Framework e .NET Core versões anteriores à 2.1: path é uma string de comprimento zero, contém apenas espaço em branco ou contém caracteres inválidos. 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 referir-se a um disco não mapeado.
path é um nome de ficheiro.
O caminho, nome do ficheiro ou combinação especificados excedem o comprimento máximo definido pelo sistema.
O interlocutor não tem a permissão necessária.
O interlocutor não tem a permissão necessária.
Observações
searchPattern pode ser uma combinação de caracteres literais e coringa, mas não suporta expressões regulares. Os seguintes indicadores de wildcard são permitidos em searchPattern.
| Especificador de coringa | Resultados correspondentes |
|---|---|
| * (asterisco) | Zero ou mais personagens nessa posição. |
| ? (ponto de interrogação) | Exatamente uma personagem nessa posição. |
Personagens que não sejam o coringa são personagens literais. Por exemplo, a searchPattern cadeia "*t" procura todos os nomes que path terminam com a letra "t". A searchPattern cadeia "s*" procura todos os nomes começando path pela letra "s".
Note
Quando se usa o carácter curinga asterisco num searchPattern personagem, como "*.txt", o número de caracteres na extensão especificada afeta a pesquisa da seguinte forma:
- Se a extensão especificada tiver exatamente três caracteres, o método devolve ficheiros com extensões que começam com a extensão especificada. Por exemplo, "*.xls" devolve tanto "book.xls" como "book.xlsx".
- Em todos os outros casos, o método devolve ficheiros que correspondem exatamente à extensão especificada. Por exemplo, "*.ai" devolve "file.ai" mas não "file.aif".
Quando se usa o carácter coringa de ponto de interrogação, este método devolve apenas ficheiros que correspondem à extensão especificada. Por exemplo, dado dois ficheiros, "file1.txt" e "file1.txtother", numa diretoria, um padrão de pesquisa de "file?.txt" devolve apenas o primeiro ficheiro, enquanto um padrão de pesquisa "file*.txt" devolve ambos os ficheiros.
searchPattern não pode terminar em dois períodos ("..") nem conter dois períodos ("..") seguidos de DirectorySeparatorChar ou AltDirectorySeparatorChar, nem pode conter caracteres inválidos. Pode consultar caracteres inválidos usando o GetInvalidPathChars método.
Pode especificar a informação relativa do caminho com o path parâmetro. A informação relativa do caminho é interpretada como relativa ao diretório de trabalho atual, que pode determinar usando o GetCurrentDirectory método.
Os EnumerateFileSystemEntries métodos e GetFileSystemEntries diferem da seguinte forma: Quando usa EnumerateFileSystemEntries, pode começar a enumerar a coleção de entradas antes que toda a coleção seja devolvida; quando usa GetFileSystemEntries, deve esperar que todo o array de entradas seja devolvido antes de poder aceder ao array. Por isso, quando trabalha com muitos ficheiros e diretórios, EnumerateFileSystemEntries pode ser mais eficiente.
A coleção devolvida não é armazenada em cache; Cada chamada à 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
Devolve uma coleção enumerável de nomes de ficheiros e diretórios que correspondem a um padrão de pesquisa e opções de enumeração num 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 pesquisar. Esta cadeia não é sensível a maiúsculas minúsculas.
- searchPattern
- String
A cadeia de pesquisa para comparar com os nomes dos ficheiros e diretórios em path. Este parâmetro pode conter uma combinação de caracteres literais e coringa válidos, mas não suporta expressões regulares.
- enumerationOptions
- EnumerationOptions
Um objeto que descreve a configuração de pesquisa e enumeração a utilizar.
Devoluções
Uma coleção enumerável de entradas do sistema de ficheiros no diretório especificado por path, que correspondem 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 string de comprimento zero, contém apenas espaço em branco ou contém caracteres inválidos. 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 referir-se a um disco não mapeado.
path é um nome de ficheiro.
O caminho, nome do ficheiro ou combinação especificados excedem o comprimento máximo definido pelo sistema.
O interlocutor não tem a permissão necessária.
O interlocutor não tem a permissão necessária.
Observações
searchPattern pode ser uma combinação de caracteres literais e coringa, mas não suporta expressões regulares. Os seguintes indicadores de wildcard são permitidos em searchPattern.
| Especificador de coringa | Resultados correspondentes |
|---|---|
| * (asterisco) | Zero ou mais personagens nessa posição. |
| ? (ponto de interrogação) | Exatamente uma personagem nessa posição. |
Personagens que não sejam o coringa são personagens literais. Por exemplo, a searchPattern cadeia "*t" procura todos os nomes que path terminam com a letra "t". A searchPattern cadeia "s*" procura todos os nomes começando path pela letra "s".
Note
Quando se usa o carácter curinga asterisco num searchPattern personagem, como "*.txt", o número de caracteres na extensão especificada afeta a pesquisa da seguinte forma:
- Se a extensão especificada tiver exatamente três caracteres, o método devolve ficheiros com extensões que começam com a extensão especificada. Por exemplo, "*.xls" devolve tanto "book.xls" como "book.xlsx".
- Em todos os outros casos, o método devolve ficheiros que correspondem exatamente à extensão especificada. Por exemplo, "*.ai" devolve "file.ai" mas não "file.aif".
Quando se usa o carácter coringa de ponto de interrogação, este método devolve apenas ficheiros que correspondem à extensão especificada. Por exemplo, dado dois ficheiros, "file1.txt" e "file1.txtother", numa diretoria, um padrão de pesquisa de "file?.txt" devolve apenas o primeiro ficheiro, enquanto um padrão de pesquisa "file*.txt" devolve ambos os ficheiros.
searchPattern não pode terminar em dois períodos ("..") nem conter dois períodos ("..") seguidos de DirectorySeparatorChar ou AltDirectorySeparatorChar, nem pode conter caracteres inválidos. Pode consultar caracteres inválidos usando o GetInvalidPathChars método.
Pode especificar a informação relativa do caminho com o path parâmetro. A informação relativa do caminho é interpretada como relativa ao diretório de trabalho atual, que pode determinar usando o GetCurrentDirectory método.
Os EnumerateFileSystemEntries métodos e GetFileSystemEntries diferem da seguinte forma: Quando usa EnumerateFileSystemEntries, pode começar a enumerar a coleção de entradas antes que toda a coleção seja devolvida; quando usa GetFileSystemEntries, deve esperar que todo o array de entradas seja devolvido antes de poder aceder ao array. Por isso, quando trabalha com muitos ficheiros e diretórios, EnumerateFileSystemEntries pode ser mais eficiente.
A coleção devolvida não é armazenada em cache; Cada chamada à 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
Devolve uma coleção enumerável de nomes de ficheiros e nomes de diretórios que correspondem a um padrão de pesquisa num caminho especificado, e opcionalmente pesquisa em 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 pesquisar. Esta cadeia não é sensível a maiúsculas minúsculas.
- searchPattern
- String
A cadeia de pesquisa para comparar com entradas do sistema de ficheiros em path. Este parâmetro pode conter uma combinação de caracteres válidos de path literais e wildcard (* e ?), mas não suporta 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 predefinido é TopDirectoryOnly.
Devoluções
Uma coleção enumerável de entradas do sistema de ficheiros no diretório especificado por path e que correspondem ao padrão de pesquisa e opção especificados.
Exceções
.NET Framework e .NET Core versões anteriores à 2.1: path é uma string de comprimento zero, contém apenas espaço em branco ou contém caracteres inválidos. 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 referir-se a um disco não mapeado.
path é um nome de ficheiro.
O caminho, nome do ficheiro ou combinação especificados excedem o comprimento máximo definido pelo sistema.
O interlocutor não tem a permissão necessária.
O interlocutor não tem a permissão necessária.
Observações
searchPattern pode ser uma combinação de caracteres literais e coringa, mas não suporta expressões regulares. Os seguintes indicadores de wildcard são permitidos em searchPattern.
| Especificador de coringa | Resultados correspondentes |
|---|---|
| * (asterisco) | Zero ou mais personagens nessa posição. |
| ? (ponto de interrogação) | Exatamente uma personagem nessa posição. |
Personagens que não sejam o coringa são personagens literais. Por exemplo, a searchPattern cadeia "*t" procura todos os nomes que path terminam com a letra "t". A searchPattern cadeia "s*" procura todos os nomes começando path pela letra "s".
Note
Quando se usa o carácter curinga asterisco num searchPattern personagem, como "*.txt", o número de caracteres na extensão especificada afeta a pesquisa da seguinte forma:
- Se a extensão especificada tiver exatamente três caracteres, o método devolve ficheiros com extensões que começam com a extensão especificada. Por exemplo, "*.xls" devolve tanto "book.xls" como "book.xlsx".
- Em todos os outros casos, o método devolve ficheiros que correspondem exatamente à extensão especificada. Por exemplo, "*.ai" devolve "file.ai" mas não "file.aif".
Quando se usa o carácter coringa de ponto de interrogação, este método devolve apenas ficheiros que correspondem à extensão especificada. Por exemplo, dado dois ficheiros, "file1.txt" e "file1.txtother", numa diretoria, um padrão de pesquisa de "file?.txt" devolve apenas o primeiro ficheiro, enquanto um padrão de pesquisa "file*.txt" devolve ambos os ficheiros.
searchPattern não pode terminar em dois períodos ("..") nem conter dois períodos ("..") seguidos de DirectorySeparatorChar ou AltDirectorySeparatorChar, nem pode conter caracteres inválidos. Pode consultar caracteres inválidos usando o GetInvalidPathChars método.
Pode especificar a informação relativa do caminho com o path parâmetro. A informação relativa do caminho é interpretada como relativa ao diretório de trabalho atual, que pode determinar usando o GetCurrentDirectory método.
Os EnumerateFileSystemEntries métodos e GetFileSystemEntries diferem da seguinte forma: Quando usa EnumerateFileSystemEntries, pode começar a enumerar a coleção de entradas antes que toda a coleção seja devolvida; quando usa GetFileSystemEntries, deve esperar que todo o array de entradas seja devolvido antes de poder aceder ao array. Por isso, quando trabalha com muitos ficheiros e diretórios, EnumerateFileSystemEntries pode ser mais eficiente.
A coleção devolvida não é armazenada em cache; Cada chamada à GetEnumerator coleção iniciará uma nova enumeração.
