FileSystemProxy.GetDirectories 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 cadeias que representam os nomes de caminhos dos subdiretórios dentro de um diretório.
Sobrecargas
| Name | Description |
|---|---|
| GetDirectories(String) |
Devolve uma coleção de cadeias que representam os nomes de caminhos dos subdiretórios dentro de um diretório. |
| GetDirectories(String, SearchOption, String[]) |
Devolve uma coleção de cadeias que representam os nomes de caminhos dos subdiretórios dentro de um diretório. |
GetDirectories(String)
Devolve uma coleção de cadeias que representam os nomes de caminhos dos subdiretórios dentro de um diretório.
public:
System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetDirectories(System::String ^ directory);public System.Collections.ObjectModel.ReadOnlyCollection<string> GetDirectories(string directory);member this.GetDirectories : string -> System.Collections.ObjectModel.ReadOnlyCollection<string>Public Function GetDirectories (directory As String) As ReadOnlyCollection(Of String)Parâmetros
- directory
- String
Nome e caminho do diretório.
Devoluções
Coleção apenas de leitura dos nomes de caminhos dos subdiretórios dentro 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 ou uma corda vazia.
O diretório especificado não existe.
O diretório especificado 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 diretórios na estrutura de diretórios que contêm a palavra Logs nos seus nomes e adiciona-os a ListBox1.
For Each foundDirectory In My.Computer.FileSystem.GetDirectories(
My.Computer.FileSystem.SpecialDirectories.MyDocuments,
True, "*Logs*")
ListBox1.Items.Add(foundDirectory)
Next
Este exemplo exige que tenha um ListBox nome ListBox1 no seu formulário.
Observações
A tabela seguinte lista exemplos de tarefas que envolvem o My.Computer.FileSystem.GetDirectories método.
| Para | Veja |
|---|---|
| Listar subdiretórios com um padrão específico | Como: Encontrar Subdiretórios com um Padrão Específico |
Ver também
Aplica-se a
GetDirectories(String, SearchOption, String[])
Devolve uma coleção de cadeias que representam os nomes de caminhos dos subdiretórios dentro de um diretório.
public:
System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetDirectories(System::String ^ directory, Microsoft::VisualBasic::FileIO::SearchOption searchType, ... cli::array <System::String ^> ^ wildcards);public System.Collections.ObjectModel.ReadOnlyCollection<string> GetDirectories(string directory, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] wildcards);member this.GetDirectories : string * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>Public Function GetDirectories (directory As String, searchType As SearchOption, ParamArray wildcards As String()) As ReadOnlyCollection(Of String)Parâmetros
- directory
- String
Nome e caminho do diretório.
- searchType
- SearchOption
Se deve incluir subpastas. A predefinição é SearchOption.SearchTopLevelOnly.
- wildcards
- String[]
Padrão para corresponder aos nomes.
Devoluções
Coleção apenas de leitura dos nomes de caminhos dos subdiretórios dentro 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 \\.\).
Um ou mais dos caracteres coringa especificados é Nothing, uma cadeia vazia, ou contém apenas espaços.
O diretório especificado não existe.
O diretório especificado 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 diretórios na estrutura de diretórios que contêm a palavra Logs nos seus nomes e adiciona-os a ListBox1.
For Each foundDirectory In My.Computer.FileSystem.GetDirectories(
My.Computer.FileSystem.SpecialDirectories.MyDocuments,
True, "*Logs*")
ListBox1.Items.Add(foundDirectory)
Next
Este exemplo exige que tenha um ListBox nome ListBox1 no seu formulário.
Observações
Pode usar o wildcards parâmetro para especificar um padrão específico. Se quiser incluir o conteúdo dos subdiretórios na pesquisa, defina o searchType parâmetro para SearchAllSubDirectories.
Uma coleção vazia é devolvida se não forem encontrados diretórios que correspondam ao padrão especificado.
A tabela seguinte lista exemplos de tarefas que envolvem o My.Computer.FileSystem.GetDirectories método.
| Para | Veja |
|---|---|
| Listar subdiretórios com um padrão específico | Como: Encontrar Subdiretórios com um Padrão Específico |