FileSystem.FindInFiles Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Devolve uma coleção de sequências de leitura sozinha que representam os nomes dos ficheiros que contêm o texto especificado.
Sobrecargas
| Name | Description |
|---|---|
| FindInFiles(String, String, Boolean, SearchOption) |
Devolve uma coleção de sequências de leitura sozinha que representam os nomes dos ficheiros que contêm o texto especificado. |
| FindInFiles(String, String, Boolean, SearchOption, String[]) |
Devolve uma coleção de sequências de leitura sozinha que representam os nomes dos ficheiros que contêm o texto especificado. |
FindInFiles(String, String, Boolean, SearchOption)
Devolve uma coleção de sequências de leitura sozinha que representam os nomes dos ficheiros 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 pesquisar.
- containsText
- String
O texto da pesquisa.
- ignoreCase
- Boolean
True se a busca deve ser sensível a maiúsculas e minúsculas; caso contrário False. A predefinição é True.
- searchType
- SearchOption
Se deve incluir subpastas. A predefinição é SearchOption.SearchTopLevelOnly.
Devoluções
Coleção apenas de leitura dos nomes dos ficheiros que contêm o texto especificado.
Exceções
O caminho não é válido por uma das seguintes razões: é uma cadeia de comprimento zero; contém apenas espaço em branco; contém caracteres inválidos; ou é um caminho de dispositivo (começa por \.</code>).
directory é Nothing ou uma corda vazia.
O diretório especificado não existe.
O diretório especificado aponta para um ficheiro existente.
O percurso excede o comprimento máximo definido pelo sistema.
O caminho do diretório especificado contém dois pontos (:) ou está num formato inválido.
O utilizador não tem as permissões necessárias para visualizar o caminho.
O utilizador não tem as permissões necessárias.
Exemplos
Este exemplo pesquisa no diretório C:\TestDir quaisquer ficheiros que contenham a cadeia "sample string" e apresenta 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 .ListBox1
Observações
Uma coleção vazia é devolvida se não forem encontrados ficheiros que correspondam ao padrão especificado.
A tabela seguinte apresenta um exemplo de uma tarefa envolvendo o My.Computer.FileSystem.FindInFiles método.
Para
Veja
Pesquise num diretório ficheiros contendo uma cadeia específica
Passo a passo: Manipulando arquivos e diretórios no Visual Basic
Ver também
Aplica-se a
FindInFiles(String, String, Boolean, SearchOption, String[])
Devolve uma coleção de sequências de leitura sozinha que representam os nomes dos ficheiros 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 pesquisar.
-
containsText
-
String
O texto da pesquisa.
-
ignoreCase
-
Boolean
True se a busca deve ser sensível a maiúsculas e minúsculas; caso contrário False. A predefinição é True.
-
searchType
-
SearchOption
Se deve incluir subpastas. A predefinição é SearchOption.SearchTopLevelOnly.
-
fileWildcards
-
String[]
Padrão a ser igualado.
Devoluções
Coleção apenas de leitura dos nomes dos ficheiros que contêm o texto especificado.
Exceções
O caminho não é válido por uma das seguintes razões: é uma cadeia de comprimento zero; contém apenas espaço em branco; contém caracteres inválidos; ou é um caminho de dispositivo (começa por \.</code>).
directory é Nothing ou uma corda vazia.
O diretório especificado não existe.
O diretório especificado aponta para um ficheiro existente.
O percurso excede o comprimento máximo definido pelo sistema.
O caminho do diretório especificado contém dois pontos (:) ou está num formato inválido.
O utilizador não tem as permissões necessárias para visualizar o caminho.
O utilizador não tem as permissões necessárias.
Exemplos
Este exemplo pesquisa no diretório C:\TestDir quaisquer ficheiros que contenham a cadeia "sample string" e apresenta 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 .ListBox1
Observações
Uma coleção vazia é devolvida se não forem encontrados ficheiros que correspondam ao padrão especificado.
A tabela seguinte apresenta um exemplo de uma tarefa envolvendo o My.Computer.FileSystem.FindInFiles método.
Para
Veja
Pesquise num diretório ficheiros contendo uma cadeia específica
Passo a passo: Manipulando arquivos e diretórios no Visual Basic
Ver também
Aplica-se a