FileSystem.FindInFiles Método

Definição

Namespace:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.Core.dll

Retorna uma coleção somente leitura de cadeias de caracteres que representam os nomes de arquivos que contêm o texto especificado.

Sobrecargas

FindInFiles(String, String, Boolean, SearchOption)	Retorna uma coleção somente leitura de cadeias de caracteres que representam os nomes de arquivos que contêm o texto especificado.
FindInFiles(String, String, Boolean, SearchOption, String[])	Retorna uma coleção somente leitura de cadeias de caracteres que representam os nomes de arquivos que contêm o texto especificado.

FindInFiles(String, String, Boolean, SearchOption)

Origem:

FileSystem.vb

Retorna uma coleção somente leitura de cadeias de caracteres que representam os nomes de arquivos que contêm o texto especificado.

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ FindInFiles(System::String ^ directory, System::String ^ containsText, bool ignoreCase, Microsoft::VisualBasic::FileIO::SearchOption searchType);

public static System.Collections.ObjectModel.ReadOnlyCollection<string> FindInFiles (string directory, string containsText, bool ignoreCase, Microsoft.VisualBasic.FileIO.SearchOption searchType);

static member FindInFiles : string * string * bool * Microsoft.VisualBasic.FileIO.SearchOption -> System.Collections.ObjectModel.ReadOnlyCollection<string>

Public Shared Function FindInFiles (directory As String, containsText As String, ignoreCase As Boolean, searchType As SearchOption) As ReadOnlyCollection(Of String)

Parâmetros

directory

String

O diretório a ser pesquisado.

containsText

String

O texto de pesquisa.

ignoreCase

Boolean

True se a pesquisa deve diferenciar maiúsculas de minúsculas; Caso contrário, False. O padrão é True.

searchType

SearchOption

Indica se subpastas devem ser incluídas. O padrão é SearchOption.SearchTopLevelOnly.

Retornos

ReadOnlyCollection<String>

Coleção somente leitura dos nomes de arquivos que contêm o texto especificado.

Exceções

ArgumentException

O caminho não é válido por um dos seguintes motivos: é uma cadeia de caracteres de comprimento zero; ele contém apenas espaço em branco; ele contém caracteres inválidos; ou é um caminho de dispositivo (começa com \.</code>).

ArgumentNullException

directory é Nothing ou é uma cadeia de caracteres vazia.

DirectoryNotFoundException

O diretório especificado não existe.

IOException

O diretório especificado aponta para um arquivo existente.

PathTooLongException

O caminho excede o tamanho máximo definido pelo sistema.

NotSupportedException

O diretório especificado no caminho contém dois-pontos (:) ou está em um formato inválido.

SecurityException

O usuário não tem as permissões necessárias para exibir o caminho.

UnauthorizedAccessException

O usuário não tem as permissões necessárias.

Exemplos

Este exemplo pesquisa o diretório em busca de C:\TestDir arquivos que contenham a cadeia de "sample string" caracteres e exibe os resultados em 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 In list
    ListBox1.Items.Add(name)
Next

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

Comentários

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

A tabela a seguir lista um exemplo de uma tarefa envolvendo o My.Computer.FileSystem.FindInFiles método .

Para	Consulte
Pesquisa um diretório para arquivos que contêm uma cadeia de caracteres específica	Instruções passo a passo: manipulando arquivos e diretórios no Visual Basic

Confira também

• SearchOption
• ReadOnlyCollection<T>

FindInFiles(String, String, Boolean, SearchOption, String[])

Origem:

FileSystem.vb

Retorna uma coleção somente leitura de cadeias de caracteres que representam os nomes de arquivos que contêm o texto especificado.

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ FindInFiles(System::String ^ directory, System::String ^ containsText, bool ignoreCase, Microsoft::VisualBasic::FileIO::SearchOption searchType, ... cli::array <System::String ^> ^ fileWildcards);

public static System.Collections.ObjectModel.ReadOnlyCollection<string> FindInFiles (string directory, string containsText, bool ignoreCase, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] fileWildcards);

static member FindInFiles : string * string * bool * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>

Public Shared Function FindInFiles (directory As String, containsText As String, ignoreCase As Boolean, searchType As SearchOption, ParamArray fileWildcards As String()) As ReadOnlyCollection(Of String)

Parâmetros

directory

String

O diretório a ser pesquisado.

containsText

String

O texto de pesquisa.

ignoreCase

Boolean

True se a pesquisa deve diferenciar maiúsculas de minúsculas; Caso contrário, False. O padrão é True.

searchType

SearchOption

Indica se subpastas devem ser incluídas. O padrão é SearchOption.SearchTopLevelOnly.

fileWildcards

String[]

Padrão para correspondência.

Retornos

ReadOnlyCollection<String>

Coleção somente leitura dos nomes de arquivos que contêm o texto especificado.

Exceções

ArgumentException

O caminho não é válido por um dos seguintes motivos: é uma cadeia de caracteres de comprimento zero; ele contém apenas espaço em branco; ele contém caracteres inválidos; ou é um caminho de dispositivo (começa com \.</code>).

ArgumentNullException

directory é Nothing ou é uma cadeia de caracteres vazia.

DirectoryNotFoundException

O diretório especificado não existe.

IOException

O diretório especificado aponta para um arquivo existente.

PathTooLongException

O caminho excede o tamanho máximo definido pelo sistema.

NotSupportedException

O diretório especificado no caminho contém dois-pontos (:) ou está em um formato inválido.

SecurityException

O usuário não tem as permissões necessárias para exibir o caminho.

UnauthorizedAccessException

O usuário não tem as permissões necessárias.

Exemplos

Este exemplo pesquisa o diretório em busca de C:\TestDir arquivos que contenham a cadeia de "sample string" caracteres e exibe os resultados em 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 In list
    ListBox1.Items.Add(name)
Next

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

Comentários

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

A tabela a seguir lista um exemplo de uma tarefa envolvendo o My.Computer.FileSystem.FindInFiles método .

Para	Consulte
Pesquisa um diretório para arquivos que contêm uma cadeia de caracteres específica	Instruções passo a passo: manipulando arquivos e diretórios no Visual Basic

Confira também

• SearchOption
• ReadOnlyCollection<T>