Método My.Computer.FileSystem.FindInFiles

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.

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

Permissões

A permissão a seguir pode ser necessária:

Para obter mais informações, consulte Segurança de Acesso de código e Solicitando permissões.

Consulte também

Tarefas

Demonstra Passo a passo: Manipular arquivos e pastas no Visual Basic

Referência

Objeto My.Computer.FileSystem

Enumeração SearchOption

System.Collections.ObjectModel.ReadOnlyCollection<T>

FileSystem.FindInFiles