Directory.EnumerateFileSystemEntries Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Retorna uma coleção enumerável de entradas do sistema de arquivos que atendem ao critério especificado.

Sobrecargas

EnumerateFileSystemEntries(String)	Retorna uma coleção enumerável de nomes de arquivo e 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 a 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

Retorna uma coleção enumerável de nomes de arquivo e 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. Esta cadeia de caracteres não diferencia maiúsculas de minúsculas.

Retornos

IEnumerable<String>

Uma coleção enumerável de entradas de sistema de arquivos no diretório especificado por path.

Exceções

ArgumentException

Versões do .NET Framework e do .NET Core anteriores à 2.1: path é uma cadeia de caracteres de comprimento zero, contém apenas espaço em branco ou contém caracteres inválidos. Consulte caracteres inválidos usando o método GetInvalidPathChars().

ArgumentNullException

path é null.

DirectoryNotFoundException

path é inválido, como referenciar uma unidade não mapeada.

IOException

path é um nome de arquivo.

PathTooLongException

O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.

SecurityException

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

UnauthorizedAccessException

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 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ê usa GetFileSystemEntries, deve 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 o GetEnumerator na coleção iniciará uma nova enumeração.

EnumerateFileSystemEntries(String, String)

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. Esta cadeia de caracteres não diferencia maiúsculas de minúsculas.

searchPattern

String

A cadeia de caracteres de pesquisa para correspondência com os nomes das entradas do sistema de arquivos em path. 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<String>

Uma coleção enumerável de entradas do sistema de arquivos no diretório especificado por path e que correspondem ao padrão de pesquisa especificado.

Exceções

ArgumentException

Versões do .NET Framework e do .NET Core anteriores à 2.1: path é uma cadeia de caracteres de comprimento zero, contém apenas espaço em branco ou contém caracteres inválidos. Consulte caracteres inválidos usando o método GetInvalidPathChars().

- ou -

searchPattern não contém um padrão válido.

ArgumentNullException

path é null.

- ou -

searchPattern é null.

DirectoryNotFoundException

path é inválido, como referenciar uma unidade não mapeada.

IOException

path é um nome de arquivo.

PathTooLongException

O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.

SecurityException

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

UnauthorizedAccessException

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)	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".

Observação

Quando você usa o caractere curinga asterisco em um searchPattern 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 "file?.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 por DirectorySeparatorChar ou AltDirectorySeparatorChar, nem pode conter caracteres inválidos. Consulte caracteres inválidos usando o método GetInvalidPathChars.

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 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ê usa GetFileSystemEntries, deve 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 o GetEnumerator na coleção iniciará uma nova enumeração.

EnumerateFileSystemEntries(String, String, EnumerationOptions)

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 a 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. Esta cadeia de caracteres não diferencia maiúsculas de minúsculas.

searchPattern

String

A cadeia de caracteres de pesquisa para correspondência com os nomes de arquivo e de 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

IEnumerable<String>

Uma coleção enumerável de entradas do sistema de arquivos no diretório especificado por path e que correspondem às opções de enumeração e ao padrão de pesquisa especificados.

Exceções

ArgumentException

Versões do .NET Framework e do .NET Core anteriores à 2.1: path é uma cadeia de caracteres de comprimento zero, contém apenas espaço em branco ou contém caracteres inválidos. Consulte caracteres inválidos usando o método GetInvalidPathChars().

- ou -

searchPattern não contém um padrão válido.

ArgumentNullException

path é null.

- ou -

searchPattern é null.

ArgumentOutOfRangeException

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

DirectoryNotFoundException

path é inválido, como referenciar uma unidade não mapeada.

IOException

path é um nome de arquivo.

PathTooLongException

O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.

SecurityException

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

UnauthorizedAccessException

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)	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*" procura todos os nomes no path início com a letra "s".

Observação

Quando você usa o caractere curinga asterisco em um searchPattern 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 "file?.txt" retorna apenas o primeiro arquivo, enquanto um padrão de pesquisa de "file*.txt" retorna os dois arquivos.

searchPattern não pode terminar em dois períodos ("..") ou conter dois períodos ("..") seguidos por DirectorySeparatorChar ou AltDirectorySeparatorChar, nem pode conter caracteres inválidos. Consulte caracteres inválidos usando o método GetInvalidPathChars.

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 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ê usa GetFileSystemEntries, deve 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 o GetEnumerator na coleção iniciará uma nova enumeração.

EnumerateFileSystemEntries(String, String, SearchOption)

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. Esta cadeia de caracteres não diferencia maiúsculas de minúsculas.

searchPattern

String

A cadeia de caracteres de pesquisa para correspondência com as entradas do sistema de arquivos no path. 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<String>

Uma coleção enumerável de entradas do sistema de arquivos no diretório especificado por path e que corresponde à opção e ao padrão de pesquisa especificados.

Exceções

ArgumentException

Versões do .NET Framework e do .NET Core anteriores à 2.1: path é uma cadeia de caracteres de comprimento zero, contém apenas espaço em branco ou contém caracteres inválidos. Consulte caracteres inválidos usando o método GetInvalidPathChars().

- ou -

searchPattern não contém um padrão válido.

ArgumentNullException

path é null.

- ou -

searchPattern é null.

ArgumentOutOfRangeException

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

DirectoryNotFoundException

path é inválido, como referenciar uma unidade não mapeada.

IOException

path é um nome de arquivo.

PathTooLongException

O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.

SecurityException

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

UnauthorizedAccessException

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)	Exatamente um caractere nessa posição.

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

Observação

Quando você usa o caractere curinga asterisco em um searchPattern 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 "file?.txt" retorna apenas o primeiro arquivo, enquanto um padrão de pesquisa de "file*.txt" retorna os dois arquivos.

searchPattern não pode terminar em dois períodos ("..") ou conter dois períodos ("..") seguidos por DirectorySeparatorChar ou AltDirectorySeparatorChar, nem pode conter caracteres inválidos. Consulte caracteres inválidos usando o método GetInvalidPathChars.

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 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ê usa GetFileSystemEntries, deve 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 o GetEnumerator na coleção iniciará uma nova enumeração.