Método My.Computer.FileSystem.FindInFiles
Retorna uma coleção de sequências de caracteres somente leitura que representa os nomes dos arquivos em um diretório.
' Usage
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.GetFiles(directory)
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.GetFiles(directory ,searchType ,wildcards)
' Declaration
Public Function GetFiles( _
ByVal directory As String _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)
' -or-
Public Function GetFiles( _
ByVal directory As String, _
ByVal searchType As SearchOption, _
ByVal wildcards As String() _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)
Parâmetros
directory
String.Diretório a ser pesquisada.Obrigatório.searchType
Enumeração SearchOption.Se deseja incluir subpastas.O padrão é SearchOption.SearchTopLevelOnly.Obrigatório.wildcards
String.Padrão a ser verificado por correspondência.Obrigatório.
Valor de retorno
Coleção de sequências de caracteres somente leitura.
Exceções
As seguintes condições podem causar uma exceção:
O caminho inválido para um dos seguintes motivos: Ele é uma cadeia de comprimento zero; ele contém somente espaços em branco; ele contém caracteres inválidos; ou é um caminho de dispositivo (começa com \\.\) (ArgumentException).
O caminho não é válido porque ele é Nothing (ArgumentNullException).
directory não existe. (DirectoryNotFoundException).
directory aponta para um arquivo existente (IOException).
O caminho excede o comprimento máximo definido pelo sistema (PathTooLongException).
Um nome de arquivo ou de diretório no caminho contém dois-pontos (:) ou está em um formato inválido (NotSupportedException).
O usuário não possui permissões necessárias para exibir o caminho (SecurityException).
O usuário não possui as permissões necessárias (UnauthorizedAccessException).
Comentários
Uma coleção vazia é retornada se nenhum arquivo que corresponda ao padrão especificado for encontrado.
Tarefas
A tabela a seguir lista exemplos de tarefas envolvendo o método My.Computer.FileSystem.GetFiles.
Para |
Consulte |
---|---|
Como: Obter a coleção de arquivos em uma pasta |
Como: Obtenha a coleção de arquivos em um diretório no Visual Basic |
Localizar arquivos com um padrão específico em um diretório |
Como: Localizar arquivos com um padrão específico no Visual Basic |
Exemplo
O exemplo a seguir retorna todos os arquivos no diretório e os adiciona à ListBox1.
For Each foundFile As String In My.Computer.FileSystem.GetFiles _
(My.Computer.FileSystem.SpecialDirectories.MyDocuments)
ListBox1.Items.Add(foundFile)
Next
Este exemplo requer que você tenha uma ListBox de nome ListBox1 no seu formulário.
Este exemplo retorna todos os arquivos no diretório com a extensão .dll e os adiciona à ListBox1.
For Each foundFile As String In My.Computer.FileSystem.GetFiles _
(My.Computer.FileSystem.SpecialDirectories.MyDocuments, _
FileIO.SearchOption.SearchTopLevelOnly, "*.txt")
ListBox1.Items.Add(foundFile)
Next
Este exemplo requer que você tenha uma ListBox de nome ListBox1 no seu formulário.
Requisitos
Namespace:Microsoft.VisualBasic.MyServices
Classe:FileSystemProxy (fornece acesso a FileSystem)
Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)
Disponibilidade por Tipo de Projeto
Tipo de Projeto |
Disponível |
---|---|
Aplicativo do Windows |
Sim |
Biblioteca de Classe |
Sim |
Aplicativo de Console |
Sim |
Biblioteca de Controle do Windows |
Sim |
Biblioteca de Controle da Web |
Sim |
Serviço do Windows |
Sim |
Site |
Sim |
Permissões
A permissão a seguir pode ser necessária:
Permissão |
Descrição |
---|---|
Controla a habilidade de acesso a arquivos e pastas.Enumeração associada: Unrestricted. |
Para obter mais informações, consulte Segurança de Acesso de código e Solicitando permissões.
Consulte também
Tarefas
Como: Localizar arquivos com um padrão específico no Visual Basic
Como: Obtenha a coleção de arquivos em um diretório no Visual Basic