FileSystemProxy.GetFiles Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Devolve uma coleção de strings de apenas leitura que representam os nomes dos ficheiros dentro de um diretório.
Sobrecargas
| Name | Description |
|---|---|
| GetFiles(String, SearchOption, String[]) |
Devolve uma coleção de strings de apenas leitura que representam os nomes dos ficheiros dentro de um diretório. |
| GetFiles(String) |
Devolve uma coleção de strings de apenas leitura que representam os nomes dos ficheiros dentro de um diretório. |
GetFiles(String, SearchOption, String[])
Devolve uma coleção de strings de apenas leitura que representam os nomes dos ficheiros dentro 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
Se deve incluir subpastas. A predefinição é SearchOption.SearchTopLevelOnly.
- wildcards
- String[]
Padrão a ser igualado.
Devoluções
Coleção de nomes de ficheiros apenas de leitura do diretório especificado.
Exceções
O caminho não é válido por uma das seguintes razões: é uma cadeia de comprimento zero; contém apenas espaço em branco; contém caracteres inválidos; Ou é um caminho de dispositivo (começa por \\.\).
directory é Nothing.
O diretório para pesquisa não existe.
directory aponta para um ficheiro existente.
O percurso excede o comprimento máximo definido pelo sistema.
Um nome de ficheiro ou diretório no caminho contém dois pontos (:) ou está num formato inválido.
O utilizador não tem as permissões necessárias para visualizar o caminho.
O utilizador não tem as permissões necessárias.
Exemplos
O exemplo seguinte devolve todos os ficheiros do diretório e adiciona-os a ListBox1.
For Each foundFile In My.Computer.FileSystem.GetFiles(
My.Computer.FileSystem.SpecialDirectories.MyDocuments)
ListBox1.Items.Add(foundFile)
Next
Este exemplo exige que tenha um ListBox nome ListBox1 no seu formulário.
Este exemplo devolve todos os ficheiros do diretório com a extensão .txt e adiciona-os 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 tenha um ListBox nome ListBox1 no seu formulário.
Observações
Uma coleção vazia é devolvida se não forem encontrados ficheiros que correspondam ao padrão especificado.
A tabela seguinte lista exemplos de tarefas que envolvem o My.Computer.FileSystem.GetFiles método.
| Para | Veja |
|---|---|
| Obtenha a coleção de ficheiros num diretório | Como: Obter a coleção de arquivos em um diretório |
| Encontre ficheiros com um padrão específico num diretório | Como: Encontrar ficheiros com um padrão específico |
Ver também
- SearchOption
- ReadOnlyCollection<T>
- Objects (Visual Basic)
- Como: Encontrar ficheiros com um padrão específico em Visual Basic
- Como: Obter a coleção de ficheiros num diretório em Visual Basic
Aplica-se a
GetFiles(String)
Devolve uma coleção de strings de apenas leitura que representam os nomes dos ficheiros dentro 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.
Devoluções
Coleção de nomes de ficheiros apenas de leitura do diretório especificado.
Exceções
O caminho não é válido por uma das seguintes razões: é uma cadeia de comprimento zero; contém apenas espaço em branco; contém caracteres inválidos; Ou é um caminho de dispositivo (começa por \\.\).
directory é Nothing.
O diretório para pesquisa não existe.
directory aponta para um ficheiro existente.
O percurso excede o comprimento máximo definido pelo sistema.
Um nome de ficheiro ou diretório no caminho contém dois pontos (:) ou está num formato inválido.
O utilizador não tem as permissões necessárias para visualizar o caminho.
O utilizador não tem as permissões necessárias.
Exemplos
O exemplo seguinte devolve todos os ficheiros do diretório e adiciona-os a ListBox1.
For Each foundFile In My.Computer.FileSystem.GetFiles(
My.Computer.FileSystem.SpecialDirectories.MyDocuments)
ListBox1.Items.Add(foundFile)
Next
Este exemplo exige que tenha um ListBox nome ListBox1 no seu formulário.
Este exemplo devolve todos os ficheiros do diretório com a extensão .txt e adiciona-os 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 tenha um ListBox nome ListBox1 no seu formulário.
Observações
Uma coleção vazia é devolvida se não forem encontrados ficheiros que correspondam ao padrão especificado.
A tabela seguinte lista exemplos de tarefas que envolvem o My.Computer.FileSystem.GetFiles método.
| Para | Veja |
|---|---|
| Obtenha a coleção de ficheiros num diretório | Como: Obter a coleção de arquivos em um diretório |
| Encontre ficheiros com um padrão específico num diretório | Como: Encontrar ficheiros com um padrão específico |
Ver também
- ReadOnlyCollection<T>
- Objects (Visual Basic)
- Como: Encontrar ficheiros com um padrão específico em Visual Basic
- Como: Obter a coleção de ficheiros num diretório em Visual Basic