FileSystemProxy.GetFiles 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 em um diretório.
Sobrecargas
| Nome | Description |
|---|---|
| GetFiles(String, SearchOption, String[]) |
Retorna uma coleção somente leitura de cadeias de caracteres que representam os nomes dos arquivos em um diretório. |
| GetFiles(String) |
Retorna uma coleção somente leitura de cadeias de caracteres que representam os nomes dos arquivos em um diretório. |
GetFiles(String, SearchOption, String[])
Retorna uma coleção somente leitura de cadeias de caracteres que representam os nomes dos arquivos em um diretório.
public:
System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory, Microsoft::VisualBasic::FileIO::SearchOption searchType, ... cli::array <System::String ^> ^ wildcards);public System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles(string directory, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] wildcards);member this.GetFiles : string * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>Public 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
Se deve incluir subpastas. O padrão é SearchOption.SearchTopLevelOnly.
- wildcards
- String[]
Padrão a ser correspondido.
Retornos
Coleção somente leitura de nomes de arquivo do diretório 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 \\.\).
directory é Nothing.
O diretório a ser pesquisado não existe.
directory aponta para um arquivo existente.
O caminho excede o comprimento máximo definido pelo sistema.
Um nome de arquivo ou diretório no caminho 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
O exemplo a seguir retorna todos os arquivos no diretório e os adiciona a 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 será 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 | Veja |
|---|---|
| Obter a coleção de arquivos em um diretório | Como obter a coleção de arquivos em um diretório |
| Localizar arquivos com um padrão específico em um diretório | Como localizar arquivos com um padrão específico |
Confira também
- SearchOption
- ReadOnlyCollection<T>
- Objetos (Visual Basic)
- Como localizar arquivos com um padrão específico em Visual Basic
- How to: Get the Collection of Files in a Directory in Visual Basic
Aplica-se a
GetFiles(String)
Retorna uma coleção somente leitura de cadeias de caracteres que representam os nomes dos arquivos em um diretório.
public:
System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory);public System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles(string directory);member this.GetFiles : string -> System.Collections.ObjectModel.ReadOnlyCollection<string>Public 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 arquivo do diretório 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 \\.\).
directory é Nothing.
O diretório a ser pesquisado não existe.
directory aponta para um arquivo existente.
O caminho excede o comprimento máximo definido pelo sistema.
Um nome de arquivo ou diretório no caminho 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
O exemplo a seguir retorna todos os arquivos no diretório e os adiciona a 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 será 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 | Veja |
|---|---|
| Obter a coleção de arquivos em um diretório | Como obter a coleção de arquivos em um diretório |
| Localizar arquivos com um padrão específico em um diretório | Como localizar arquivos com um padrão específico |
Confira também
- ReadOnlyCollection<T>
- Objetos (Visual Basic)
- Como localizar arquivos com um padrão específico em Visual Basic
- How to: Get the Collection of Files in a Directory in Visual Basic