Share via


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

O GetFiles método 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. 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
    

    Este exemplo de código também está disponível como um trecho de código IntelliSense. No selecionador do trecho de código, ele está localizado no File system - Processing Drives, Folders, and Files. Para obter mais informações, consulte Como: Inserir trechos de código de IntelliSense.

Programação robusta

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

  • O caminho não é válido para um dos seguintes motivos: ela é 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 de Visual Basic

Como: Localizar subdiretórios com um padrão específico em Visual Basic

Referência

GetFiles