Partilhar via


FileSystem.FindInFiles Método

Definição

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
Origem:
FileSystem.vb
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

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

Exceções

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>).

directory é Nothing ou é uma cadeia de caracteres vazia.

O diretório especificado não existe.

O diretório especificado aponta para um arquivo existente.

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

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

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

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

Aplica-se a

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

Origem:
FileSystem.vb
Origem:
FileSystem.vb
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

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

Exceções

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>).

directory é Nothing ou é uma cadeia de caracteres vazia.

O diretório especificado não existe.

O diretório especificado aponta para um arquivo existente.

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

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

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

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

Aplica-se a