Método My.Computer.FileSystem.GetDirectories

Artigo
08/25/2010

Retorna uma coleção de strings representando os nomes dos caminhos dos subdiretórios em um Diretório.

' Usage
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.GetDirectories(directory)
Dim value As System.Collections.ObjectModel.ReadOnlyCollection(Of String) = My.Computer.FileSystem.GetDirectories(directory ,searchType ,wildcards)
' Declaration
Public Function GetDirectories( _
   ByVal directory As String _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)
' -or-
Public Function GetDirectories( _
   ByVal directory As String, _
   ByVal searchType As SearchOption, _
   ByVal wildcards As String() _
) As System.Collections.ObjectModel.ReadOnlyCollection(Of String)

Parâmetros

directory
String.Nome e caminho do diretório.Obrigatório.
searchType
Enumeração SearchOption.Se deseja incluir subpastas.O padrão é SearchOption.SearchTopLevelOnly.Obrigatório.
wildcards
String.Padrão para corresponder aos nomes.Obrigatório.

Valor de retorno

Coleção somente-leitura de String.

Exceções

As seguintes condições podem produzir uma exceção:

O caminho inválido para um dos seguintes motivos: Ele é uma cadeia de comprimento zero; ele contém somente espaços em branco; ele contém caracteres inválidos; ou é um caminho de dispositivo (começa com \\.\) (ArgumentException).
O caminho não é válido porque ele é Nothing (ArgumentNullException).
Um ou mais dos caracteres curinga especificados é Nothing, uma sequência vazia, ou contém apenas espaços (ArgumentNullException).
directory não existe. (DirectoryNotFoundException).
directory aponta para um arquivo existente (IOException).
O caminho excede o comprimento máximo definido pelo sistema (PathTooLongException).
Um nome de arquivo ou de diretório no caminho contém dois-pontos (:) ou está em um formato inválido (NotSupportedException).
O usuário não possui permissões necessárias para exibir o caminho (SecurityException).
O usuário não possui as permissões necessárias (UnauthorizedAccessException).

Comentários

Você pode usar o parâmetro wildcards para especificar um padrão.Se você deseja incluir o conteúdo de subpastas na pesquisa, defina o parâmetro searchType como SearchAllSubDirectories.

Uma coleção vazia é retornada se nenhum diretório for encontrado que correspondam ao padrão especificado.

Tarefas

A tabela a seguir lista exemplos de tarefas envolvendo o método My.Computer.FileSystem.GetDirectories.

Para	Consulte
Listar subdiretórios com um padrão específico	Como: Localizar subdiretórios com um padrão específico no Visual Basic

Exemplo

O exemplo a seguir retorna todas as pastas da estrutura de diretórios que contêm a palavra Logs em seus nomes e as adiciona em ListBox1.

For Each foundDirectory As String In _
My.Computer.FileSystem.GetDirectories _
(My.Computer.FileSystem.SpecialDirectories.MyDocuments, _
True, "*Logs*")
    ListBox1.Items.Add(foundDirectory)
Next

Este exemplo requer que você tenha uma ListBox de nome ListBox1 no seu formulário.

Requisitos

Namespace:Microsoft.VisualBasic.MyServices

Classe:FileSystemProxy (fornece acesso a FileSystem)

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Disponibilidade por Tipo de Projeto

Tipo de Projeto	Disponível
Aplicativo do Windows	Sim
Biblioteca de Classe	Sim
Aplicativo de Console	Sim
Biblioteca de Controle do Windows	Sim
Biblioteca de Controle da Web	Sim
Serviço do Windows	Sim
Site	Sim