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 de arquivos de um diretório.
Sobrecargas
| GetFiles(String, SearchOption, String[]) |
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.
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
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 |
| 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 no Visual Basic
- Como obter a coleção de arquivos em um diretório no Visual Basic
Aplica-se a
GetFiles(String)
Retorna uma coleção somente leitura de cadeias de caracteres que representam os nomes de arquivos de 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 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 |
| 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 no Visual Basic
- Como obter a coleção de arquivos em um diretório no Visual Basic
