Método My.Computer.FileSystem.FindInFiles

Artigo
08/25/2010

Retorna uma coleção somente leitura de sequências de caracteres que representam os nomes de arquivos contendo o texto especificado.

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

Parâmetros

Directory
String.O diretório a ser pesquisada.Obrigatório.
containsText
String.O texto de Pesquisar.Obrigatório.
ignoreCase
Boolean.Se a Pesquisar deve ser distinção entre diferenciar diferenciar maiúsculas de minúsculas ou não.O padrão é True.Obrigatório.
searchType
Enumeração SearchOption.Se deseja incluir subpastas.O padrão é SearchOption.SearchTopLevelOnly.Obrigatório.
fileWildcards
Matriz do tipo String.Padrão a ser verificado por correspondência.Obrigatório.

Valor de retorno

Coleção do tipo String 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 \\. \) (T:System.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.FindInFiles.

Para	Consulte
Pesquisar um diretório para arquivos que contêm uma sequência específica	Demonstra Passo a passo: Manipular arquivos e pastas no Visual Basic

Exemplo

Este exemplo procura no diretório C:\TestDir por todos os arquivos que contêm a sequência de caracteres "sample string" e exibe os resultados no ListBox1.

Dim list As System.Collections.ObjectModel.ReadOnlyCollection _
(Of String)
list = My.Computer.FileSystem.FindInFiles("C:\TestDir", _
 "sample string", True, FileIO.SearchOption.SearchTopLevelOnly)
For Each name As String In list
    ListBox1.Items.Add(name)
Next

Para poder funcionar, o projeto deve conter um ListBox chamado ListBox1.

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