FileSystemProxy.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 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)
Retorna uma coleção somente leitura de cadeias de caracteres que representam os nomes de arquivos que contêm o texto especificado.
public:
System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ FindInFiles(System::String ^ directory, System::String ^ containsText, bool ignoreCase, Microsoft::VisualBasic::FileIO::SearchOption searchType);public System.Collections.ObjectModel.ReadOnlyCollection<string> FindInFiles (string directory, string containsText, bool ignoreCase, Microsoft.VisualBasic.FileIO.SearchOption searchType);member this.FindInFiles : string * string * bool * Microsoft.VisualBasic.FileIO.SearchOption -> System.Collections.ObjectModel.ReadOnlyCollection<string>Public 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 exemplos de tarefas que envolvem 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>
- Objetos (Visual Basic)
- Instruções passo a passo: manipulando arquivos e diretórios no Visual Basic
Aplica-se a
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.
public:
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 System.Collections.ObjectModel.ReadOnlyCollection<string> FindInFiles (string directory, string containsText, bool ignoreCase, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] fileWildcards);member this.FindInFiles : string * string * bool * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>Public 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 exemplos de tarefas que envolvem 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>
- Objetos (Visual Basic)
- Instruções passo a passo: manipulando arquivos e diretórios no Visual Basic
Aplica-se a
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de