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

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

• Utilize a GetFiles(String) sobrecarga para uma pesquisa de ficheiro simples numa diretoria definida, sem pesquisar subdiretórios.

• Use a GetFiles(String, SearchOption, String[]) sobrecarga para especificar opções adicionais para a sua pesquisa. 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 a pesquisa no parâmetro directory. O exemplo a seguir retorna todos os arquivos no diretório e os adiciona ao 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 de dispositivo (começa com \\.\) (ArgumentException).

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

• directory não existe (DirectoryNotFoundException).

• directory aponta para um ficheiro 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 um formato inválido (NotSupportedException).

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

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

Ver também

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