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. É possível usar o parâmetro wildCards para especificar um padrão de busca. Para incluir subdiretórios na busca, defina o parâmetro searchType para SearchOption.SearchAllSubDirectories.

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

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 inclui na 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 comprimento zero, contém apenas espaços em branco, contém caracteres inválidos ou é um caminho de 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 de diretório no caminho contém dois-pontos (:) ou está em um formato inválido (NotSupportedException).

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

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

Confira também

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