Compartilhar via


FileSystem.GetFiles Método

Definição

Retorna uma coleção somente leitura de cadeias de caracteres que representam os nomes de arquivos de um diretório.

Sobrecargas

GetFiles(String)

Retorna uma coleção somente leitura de cadeias de caracteres que representam os nomes de arquivos de um diretório.

GetFiles(String, SearchOption, String[])

Retorna uma coleção somente leitura de cadeias de caracteres que representam os nomes de arquivos de um diretório.

GetFiles(String)

Origem:
FileSystem.vb
Origem:
FileSystem.vb
Origem:
FileSystem.vb

Retorna uma coleção somente leitura de cadeias de caracteres que representam os nomes de arquivos de um diretório.

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory);
public static System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory);
static member GetFiles : string -> System.Collections.ObjectModel.ReadOnlyCollection<string>
Public Shared Function GetFiles (directory As String) As ReadOnlyCollection(Of String)

Parâmetros

directory
String

Diretório a ser pesquisado.

Retornos

Coleção somente leitura de nomes de arquivos do diretório especificado.

Exceções

O caminho não é válido por um dos seguintes motivos: é uma cadeia de comprimento zero, contém apenas espaços em branco, contém caracteres inválidos ou é um caminho de dispositivo (começa com \\.\).

directory é Nothing.

O diretório a ser pesquisado não existe.

directory aponta para um arquivo existente.

O caminho excede o tamanho máximo definido pelo sistema.

Um nome de arquivo ou de diretório no caminho contém dois-pontos (:) ou está em um formato inválido.

O usuário não tem as permissões necessárias para exibir o caminho.

O usuário não tem as permissões necessárias.

Exemplos

O exemplo a seguir retorna todos os arquivos no diretório e os inclui na ListBox1.

For Each foundFile In My.Computer.FileSystem.GetFiles(
        My.Computer.FileSystem.SpecialDirectories.MyDocuments)
    ListBox1.Items.Add(foundFile)
Next

Este exemplo exige que você tenha um ListBox nome ListBox1 em seu formulário.

Este exemplo retorna todos os arquivos no diretório com a extensão .txt e os adiciona a ListBox1.

For Each foundFile As String In My.Computer.FileSystem.GetFiles(
         My.Computer.FileSystem.SpecialDirectories.MyDocuments,
         FileIO.SearchOption.SearchTopLevelOnly, "*.txt")
    ListBox1.Items.Add(foundFile)
Next

Este exemplo exige que você tenha um ListBox nome ListBox1 em seu formulário.

Comentários

Uma coleção vazia é retornada se nenhum arquivo correspondente ao padrão especificado for encontrado.

A tabela a seguir lista exemplos de tarefas que envolvem o My.Computer.FileSystem.GetFiles método .

Para Consulte
Obter a coleção de arquivos em um diretório Como obter a coleção de arquivos em um diretório no Visual Basic
Localizar arquivos com um padrão específico em um diretório Como localizar arquivos com um padrão específico no Visual Basic

Confira também

Aplica-se a

GetFiles(String, SearchOption, String[])

Origem:
FileSystem.vb
Origem:
FileSystem.vb
Origem:
FileSystem.vb

Retorna uma coleção somente leitura de cadeias de caracteres que representam os nomes de arquivos de um diretório.

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory, Microsoft::VisualBasic::FileIO::SearchOption searchType, ... cli::array <System::String ^> ^ wildcards);
public static System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] wildcards);
static member GetFiles : string * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>
Public Shared Function GetFiles (directory As String, searchType As SearchOption, ParamArray wildcards As String()) As ReadOnlyCollection(Of String)

Parâmetros

directory
String

Diretório a ser pesquisado.

searchType
SearchOption

Indica se subpastas devem ser incluídas. O padrão é SearchOption.SearchTopLevelOnly.

wildcards
String[]

Padrão para correspondência.

Retornos

Coleção somente leitura de nomes de arquivos do diretório especificado.

Exceções

O caminho não é válido por um dos seguintes motivos: é uma cadeia de comprimento zero, contém apenas espaços em branco, contém caracteres inválidos ou é um caminho de dispositivo (começa com \\.\).

directory é Nothing.

O diretório a ser pesquisado não existe.

directory aponta para um arquivo existente.

O caminho excede o tamanho máximo definido pelo sistema.

Um nome de arquivo ou de diretório no caminho contém dois-pontos (:) ou está em um formato inválido.

O usuário não tem as permissões necessárias para exibir o caminho.

O usuário não tem as permissões necessárias.

Exemplos

O exemplo a seguir retorna todos os arquivos no diretório e os inclui na ListBox1.

For Each foundFile In My.Computer.FileSystem.GetFiles(
        My.Computer.FileSystem.SpecialDirectories.MyDocuments)
    ListBox1.Items.Add(foundFile)
Next

Este exemplo exige que você tenha um ListBox nome ListBox1 em seu formulário.

Este exemplo retorna todos os arquivos no diretório com a extensão .txt e os adiciona a ListBox1.

For Each foundFile As String In My.Computer.FileSystem.GetFiles(
         My.Computer.FileSystem.SpecialDirectories.MyDocuments,
         FileIO.SearchOption.SearchTopLevelOnly, "*.txt")
    ListBox1.Items.Add(foundFile)
Next

Este exemplo exige que você tenha um ListBox nome ListBox1 em seu formulário.

Comentários

Uma coleção vazia é retornada se nenhum arquivo correspondente ao padrão especificado for encontrado.

A tabela a seguir lista exemplos de tarefas que envolvem o My.Computer.FileSystem.GetFiles método .

Para Consulte
Obter a coleção de arquivos em um diretório Como obter a coleção de arquivos em um diretório no Visual Basic
Localizar arquivos com um padrão específico em um diretório Como localizar arquivos com um padrão específico no Visual Basic

Confira também

Aplica-se a