Compartilhar via


Como: Localizar arquivos com um padrão específico de Visual Basic

O GetFiles método retorna uma coleção somente leitura de seqüências de caracteres que representa os nomes de caminho para os arquivos. Você pode usar o parâmetro wildCards para especificar um padrão. Se você deseja incluir o 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 localizar arquivos com um padrão especificado

  • Use o método GetFiles fornecendo o nome e caminho do diretório que você deseja pesquisar e especificando o padrão. O exemplo a seguir retorna todos os arquivos com a extensão .dll no diretório e os adiciona à ListBox1.

    For Each foundFile As String In My.Computer.FileSystem.GetFiles(
        My.Computer.FileSystem.SpecialDirectories.MyDocuments,
        Microsoft.VisualBasic.FileIO.SearchOption.SearchAllSubDirectories, "*.dll")
    
        Listbox1.Items.Add(foundFile)
    Next
    

Segurança

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 arquivo ou nome da pasta no caminho contém dois-pontos (:) ou está em 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 subdiretórios com um padrão específico em Visual Basic

Solução de problemas: Leitura e gravação em arquivos de texto (Visual Basic)

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

Referência

GetFiles