Partilhar via


FileSystemProxy.GetDirectories Método

Definição

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

Confira também

Aplica-se a