FileSystem.GetFiles Método
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 de um diretório.
| GetFiles(String) |
Retorna uma coleção somente leitura de cadeias de caracteres que representam os nomes de arquivos de um diretório. |
| GetFiles(String, SearchOption, String[]) |
Retorna uma coleção somente leitura de cadeias de caracteres que representam os nomes de arquivos de um diretório. |
- 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 de um diretório.
public:
static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory);public static System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory);static member GetFiles : string -> System.Collections.ObjectModel.ReadOnlyCollection<string>Public Shared Function GetFiles (directory As String) As ReadOnlyCollection(Of String)Parâmetros
- directory
- String
Diretório a ser pesquisado.
Retornos
Coleção somente leitura de nomes de arquivos do diretório especificado.
Exceções
O caminho não é válido por um dos seguintes motivos: é uma cadeia de comprimento zero, contém apenas espaços em branco, contém caracteres inválidos ou é um caminho de dispositivo (começa com \\.\).
directory é Nothing.
O diretório a ser pesquisado não existe.
directory aponta para um arquivo existente.
O caminho excede o tamanho máximo definido pelo sistema.
Um nome de arquivo ou de diretório 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
O exemplo a seguir retorna todos os arquivos no diretório e os inclui na ListBox1.
For Each foundFile In My.Computer.FileSystem.GetFiles(
My.Computer.FileSystem.SpecialDirectories.MyDocuments)
ListBox1.Items.Add(foundFile)
Next
Este exemplo exige que você tenha um ListBox nome ListBox1 em seu formulário.
Este exemplo retorna todos os arquivos no diretório com a extensão .txt e os adiciona a 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 exige que você tenha um ListBox nome ListBox1 em seu formulário.
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.GetFiles método .
| Para | Consulte |
|---|---|
| Obter a coleção de arquivos em um diretório | Como obter 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 |
Confira também
Aplica-se a
.NET 9 e outras versões
| Produto | Versões |
|---|---|
| .NET | Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
- 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 de um diretório.
public:
static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory, Microsoft::VisualBasic::FileIO::SearchOption searchType, ... cli::array <System::String ^> ^ wildcards);public static System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] wildcards);static member GetFiles : string * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>Public Shared Function GetFiles (directory As String, searchType As SearchOption, ParamArray wildcards As String()) As ReadOnlyCollection(Of String)Parâmetros
- directory
- String
Diretório a ser pesquisado.
- searchType
- SearchOption
Indica se subpastas devem ser incluídas. O padrão é SearchOption.SearchTopLevelOnly.
- wildcards
- String[]
Padrão para correspondência.
Retornos
Coleção somente leitura de nomes de arquivos do diretório especificado.
Exceções
O caminho não é válido por um dos seguintes motivos: é uma cadeia de comprimento zero, contém apenas espaços em branco, contém caracteres inválidos ou é um caminho de dispositivo (começa com \\.\).
directory é Nothing.
O diretório a ser pesquisado não existe.
directory aponta para um arquivo existente.
O caminho excede o tamanho máximo definido pelo sistema.
Um nome de arquivo ou de diretório 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
O exemplo a seguir retorna todos os arquivos no diretório e os inclui na ListBox1.
For Each foundFile In My.Computer.FileSystem.GetFiles(
My.Computer.FileSystem.SpecialDirectories.MyDocuments)
ListBox1.Items.Add(foundFile)
Next
Este exemplo exige que você tenha um ListBox nome ListBox1 em seu formulário.
Este exemplo retorna todos os arquivos no diretório com a extensão .txt e os adiciona a 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 exige que você tenha um ListBox nome ListBox1 em seu formulário.
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.GetFiles método .
| Para | Consulte |
|---|---|
| Obter a coleção de arquivos em um diretório | Como obter 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 |
Confira também
Aplica-se a
.NET 9 e outras versões
| Produto | Versões |
|---|---|
| .NET | Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: