FileSystem.FindInFiles Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Retorna uma coleção somente leitura de cadeias de caracteres que representam os nomes dos arquivos que contêm o texto especificado.
Sobrecargas
| Nome | Description |
|---|---|
| FindInFiles(String, String, Boolean, SearchOption) |
Retorna uma coleção somente leitura de cadeias de caracteres que representam os nomes dos 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 dos arquivos que contêm o texto especificado. |
FindInFiles(String, String, Boolean, SearchOption)
Retorna uma coleção somente leitura de cadeias de caracteres que representam os nomes dos 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 da pesquisa.
- ignoreCase
- Boolean
True se a pesquisa deve diferenciar maiúsculas de minúsculas; caso contrário False. O padrão é True.
- searchType
- SearchOption
Se deve incluir subpastas. O padrão é SearchOption.SearchTopLevelOnly.
Retornos
Coleção somente leitura dos nomes dos 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 do dispositivo (começa com \.</code>).
directory é ou uma Nothing cadeia de caracteres vazia.
O diretório especificado não existe.
O diretório especificado aponta para um arquivo existente.
O caminho excede o comprimento máximo definido pelo sistema.
O caminho de diretório especificado contém dois-pontos (:) ou está em um formato inválido.
O usuário não tem 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 nome ListBox1.
Comentários
Uma coleção vazia será retornada se nenhum arquivo correspondente ao padrão especificado for encontrado.
A tabela a seguir lista um exemplo de uma tarefa que envolve o My.Computer.FileSystem.FindInFiles método.
Para
Veja
Pesquisar um diretório em busca de arquivos que contenham uma cadeia de caracteres específica
Passo a passo: manipulando arquivos e diretórios no Visual Basic
Confira também
Aplica-se a
FindInFiles(String, String, Boolean, SearchOption, String[])
Retorna uma coleção somente leitura de cadeias de caracteres que representam os nomes dos 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 da pesquisa.
-
ignoreCase
-
Boolean
True se a pesquisa deve diferenciar maiúsculas de minúsculas; caso contrário False. O padrão é True.
-
searchType
-
SearchOption
Se deve incluir subpastas. O padrão é SearchOption.SearchTopLevelOnly.
-
fileWildcards
-
String[]
Padrão a ser correspondido.
Retornos
Coleção somente leitura dos nomes dos 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 do dispositivo (começa com \.</code>).
directory é ou uma Nothing cadeia de caracteres vazia.
O diretório especificado não existe.
O diretório especificado aponta para um arquivo existente.
O caminho excede o comprimento máximo definido pelo sistema.
O caminho de diretório especificado contém dois-pontos (:) ou está em um formato inválido.
O usuário não tem 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 nome ListBox1.
Comentários
Uma coleção vazia será retornada se nenhum arquivo correspondente ao padrão especificado for encontrado.
A tabela a seguir lista um exemplo de uma tarefa que envolve o My.Computer.FileSystem.FindInFiles método.
Para
Veja
Pesquisar um diretório em busca de arquivos que contenham uma cadeia de caracteres específica
Passo a passo: manipulando arquivos e diretórios no Visual Basic
Confira também
Aplica-se a