Compartilhar via


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

O GetFiles method retorna uma coleção somente leitura de seqüências de caracteres que representa o nome dos arquivos dentro de um diretório.Você pode usar o parâmetro wildCards para especificar um padrão específico.Para incluir subpastas na pesquisa, defina o parâmetro searchType como SearchOption.SearchAllSubDirectories.

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

Para listar arquivos em um diretório

  • Use o método GetFiles fornecendo o nome e caminho do diretório que você deseja pesquisar.O exemplo a seguir retorna todos os arquivos no diretório e os adiciona à 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 para uma das seguintes razões: ele é uma seqüência de comprimento zero, ele contém somente espaços em branco, ele contém caracteres inválidos ou é um caminho de dispositivo (começa com \ \.\) (ArgumentException).

  • O caminho não é válido porque ele é 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).

Consulte também

Tarefas

Como: localizar arquivos com um padrão específico no Visual Basic

Como: localizar subpastas com um padrão específico em Visual Basic

Referência

GetFiles