Método My.Computer.FileSystem.FindInFiles

Artigo
08/25/2010

Retorna uma coleção de sequências de caracteres somente leitura que representa os nomes dos arquivos em um diretório.

' Usage
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.GetFiles(directory)
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.GetFiles(directory ,searchType ,wildcards)
' Declaration
Public Function GetFiles( _
   ByVal directory As String _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)
' -or-
Public Function GetFiles( _
   ByVal directory As String, _
   ByVal searchType As SearchOption, _
   ByVal wildcards As String() _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)

Parâmetros

directory
String.Diretório a ser pesquisada.Obrigatório.
searchType
Enumeração SearchOption.Se deseja incluir subpastas.O padrão é SearchOption.SearchTopLevelOnly.Obrigatório.
wildcards
String.Padrão a ser verificado por correspondência.Obrigatório.

Valor de retorno

Coleção de sequências de caracteres somente leitura.

Exceções

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

O caminho inválido para um dos seguintes motivos: Ele é uma cadeia 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).

Comentários

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

Tarefas

A tabela a seguir lista exemplos de tarefas envolvendo o método My.Computer.FileSystem.GetFiles.

Para	Consulte
Como: Obter a coleção de arquivos em uma pasta	Como: Obtenha a coleção de arquivos em um diretório no Visual Basic
Localizar arquivos com um padrão específico em um diretório	Como: Localizar arquivos com um padrão específico no Visual Basic

Exemplo

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 requer que você tenha uma ListBox de nome ListBox1 no seu formulário.

Este exemplo retorna todos os arquivos no diretório com a extensão .dll e os adiciona à ListBox1.

For Each foundFile As String In My.Computer.FileSystem.GetFiles _
      (My.Computer.FileSystem.SpecialDirectories.MyDocuments, _
       FileIO.SearchOption.SearchTopLevelOnly, "*.txt")
    ListBox1.Items.Add(foundFile)
Next

Este exemplo requer que você tenha uma ListBox de nome ListBox1 no seu formulário.

Requisitos

Namespace:Microsoft.VisualBasic.MyServices

Classe:FileSystemProxy (fornece acesso a FileSystem)

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Disponibilidade por Tipo de Projeto

Tipo de Projeto	Disponível
Aplicativo do Windows	Sim
Biblioteca de Classe	Sim
Aplicativo de Console	Sim
Biblioteca de Controle do Windows	Sim
Biblioteca de Controle da Web	Sim
Serviço do Windows	Sim
Site	Sim