Partilhar via


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:

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 de FileSystem.GetFiles método, fornecendo o nome e o caminho do diretório para pesquisar no directory parâmetro. 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).

Consulte também