Como obter a coleção de arquivos em um diretório no Visual Basic

As sobrecargas do método FileSystem.GetFiles retornam uma coleção somente leitura de cadeias de caracteres representando os nomes dos arquivos dentro de um diretório:

• Use a sobrecarga GetFiles(String) para fazer uma busca de arquivo simples em um diretório especificado, sem buscar em subdiretórios.

• Use a sobrecarga GetFiles(String, SearchOption, String[]) para especificar opções adicionais para a busca. Você pode usar o wildCards parâmetro para especificar um padrão de pesquisa. Para incluir subdiretórios na pesquisa, defina o searchType parâmetro como SearchOption.SearchAllSubDirectories.

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

Para listar arquivos em um diretório

• Use uma das sobrecargas do método FileSystem.GetFiles, fornecendo o nome e o caminho do diretório para buscar no parâmetro directory. O exemplo a seguir retorna todos os arquivos no diretório e os adiciona a ListBox1.

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

Programação robusta

As seguintes condições podem causar uma exceção:

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

• O caminho não é válido porque é Nothing (ArgumentNullException).

• directory não existe (DirectoryNotFoundException).

• directory aponta para um arquivo existente (IOException).

• O caminho excede o comprimento máximo definido pelo sistema (PathTooLongException).

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

• O usuário não tem permissões necessárias para exibir o caminho (SecurityException).

• O usuário não tem as permissões necessárias (UnauthorizedAccessException).

Consulte também

• GetFiles
• Como localizar arquivos com um padrão específico
• Como localizar subdiretórios com um padrão específico