FileSystemProxy.GetDirectories 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 de cadeias de caracteres que representam os nomes dos caminhos dos subdiretórios de um diretório.
Sobrecargas
| GetDirectories(String) |
Retorna uma coleção de cadeias de caracteres que representam os nomes dos caminhos dos subdiretórios de um diretório. |
| GetDirectories(String, SearchOption, String[]) |
Retorna uma coleção de cadeias de caracteres que representam os nomes dos caminhos dos subdiretórios de um diretório. |
GetDirectories(String)
Retorna uma coleção de cadeias de caracteres que representam os nomes dos caminhos dos subdiretórios 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.
Retornos
Coleção somente leitura dos nomes dos caminhos dos subdiretórios dentro 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 ou é uma cadeia de caracteres vazia.
O diretório especificado não existe.
O diretório especificado 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 diretórios na estrutura de diretório que contêm a palavra Logs em seus nomes e os adiciona 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 você tenha um ListBox nome ListBox1 em seu formulário.
Comentários
A tabela a seguir lista exemplos de tarefas que envolvem o My.Computer.FileSystem.GetDirectories método .
| Para | Consulte |
|---|---|
| Listar subdiretórios com um padrão específico | Como: localizar subdiretórios com um padrão específico |
Confira também
Aplica-se a
GetDirectories(String, SearchOption, String[])
Retorna uma coleção de cadeias de caracteres que representam os nomes dos caminhos dos subdiretórios 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
Indica se subpastas devem ser incluídas. O padrão é SearchOption.SearchTopLevelOnly.
- wildcards
- String[]
O padrão ao qual os nomes serão correspondidos.
Retornos
Coleção somente leitura dos nomes dos caminhos dos subdiretórios dentro 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 \\.\).
Um ou mais dos caracteres curinga especificados é Nothing, uma cadeia de caracteres vazia ou contém somente espaços.
O diretório especificado não existe.
O diretório especificado 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 diretórios na estrutura de diretório que contêm a palavra Logs em seus nomes e os adiciona 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 você tenha um ListBox nome ListBox1 em seu formulário.
Comentários
É possível usar o parâmetro wildcards para especificar um padrão específico. Caso deseje incluir os conteúdos dos subdiretórios na pesquisa, defina o parâmetro searchType para SearchAllSubDirectories.
Uma coleção vazia será retornada se nenhum diretório correspondente ao padrão especificado for encontrado.
A tabela a seguir lista exemplos de tarefas que envolvem o My.Computer.FileSystem.GetDirectories método .
| Para | Consulte |
|---|---|
| Listar subdiretórios com um padrão específico | Como: localizar subdiretórios com um padrão específico |
