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 de caminho de subdiretórios em um diretório.
Sobrecargas
| Nome | Description |
|---|---|
| GetDirectories(String) |
Retorna uma coleção de cadeias de caracteres que representam os nomes de caminho de subdiretórios em um diretório. |
| GetDirectories(String, SearchOption, String[]) |
Retorna uma coleção de cadeias de caracteres que representam os nomes de caminho de subdiretórios em um diretório. |
GetDirectories(String)
Retorna uma coleção de cadeias de caracteres que representam os nomes de caminho de subdiretórios em 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 de caminho de subdiretórios no 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 é ou uma Nothing cadeia de caracteres vazia.
O diretório especificado não existe.
O diretório especificado 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 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 | Veja |
|---|---|
| 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 de caminho de subdiretórios em 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. O padrão é SearchOption.SearchTopLevelOnly.
- wildcards
- String[]
Padrão para corresponder nomes.
Retornos
Coleção somente leitura dos nomes de caminho de subdiretórios no 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 \\.\).
Um ou mais dos caracteres curinga especificados são Nothing, uma cadeia de caracteres vazia ou contém apenas espaços.
O diretório especificado não existe.
O diretório especificado 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 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
Você pode usar o wildcards parâmetro para especificar um padrão específico. Se você quiser incluir o conteúdo de subdiretórios na pesquisa, defina o searchType parâmetro como 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 | Veja |
|---|---|
| Listar subdiretórios com um padrão específico | Como localizar subdiretórios com um padrão específico |