FileSystem.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.Returns a collection of strings representing the path names of subdirectories within a directory.
Sobrecargas
| GetDirectories(String) |
Retorna uma coleção de cadeias de caracteres que representam os nomes dos caminhos dos subdiretórios de um diretório.Returns a collection of strings representing the path names of subdirectories within a directory. |
| 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.Returns a collection of strings representing the path names of subdirectories within a directory. |
GetDirectories(String)
Retorna uma coleção de cadeias de caracteres que representam os nomes dos caminhos dos subdiretórios de um diretório.Returns a collection of strings representing the path names of subdirectories within a directory.
public:
static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetDirectories(System::String ^ directory);
public static System.Collections.ObjectModel.ReadOnlyCollection<string> GetDirectories (string directory);
static member GetDirectories : string -> System.Collections.ObjectModel.ReadOnlyCollection<string>
Public Shared Function GetDirectories (directory As String) As ReadOnlyCollection(Of String)
Parâmetros
- directory
- String
Nome e caminho do diretório.Name and path of directory.
Retornos
Coleção somente leitura dos nomes dos caminhos dos subdiretórios dentro do diretório especificado.Read-only collection of the path names of subdirectories within the specified directory.
Exceções
O caminho não é válido por um dos seguintes motivos: é uma cadeia de tamanho zero, contém apenas espaços em branco, contém caracteres inválidos ou é um caminho de dispositivo (começa com \\.\).The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with \\.\).
directory é Nothing ou é uma cadeia de caracteres vazia.directory is Nothing or an empty string.
O diretório especificado não existe.The specified directory does not exist.
O diretório especificado aponta para um arquivo existente.The specified directory points to an existing file.
O caminho excede o tamanho máximo definido pelo sistema.The path exceeds the system-defined maximum length.
Um nome de arquivo ou de diretório no caminho contém dois-pontos (:) ou está em um formato inválido.A file or directory name in the path contains a colon (:) or is in an invalid format.
O usuário não tem as permissões necessárias para exibir o caminho.The user lacks necessary permissions to view the path.
O usuário não tem as permissões necessárias.The user lacks necessary permissions.
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 ao ListBox1 .The following example returns all the directories in the directory structure that contain the word Logs in their names and adds them to ListBox1.
For Each foundDirectory In My.Computer.FileSystem.GetDirectories(
My.Computer.FileSystem.SpecialDirectories.MyDocuments,
True, "*Logs*")
ListBox1.Items.Add(foundDirectory)
Next
Este exemplo requer que você tenha um ListBox nome ListBox1 em seu formulário.This example requires that you have a ListBox named ListBox1 on your form.
Comentários
A tabela a seguir lista um exemplo de uma tarefa que envolve o My.Computer.FileSystem.GetDirectories método.The following table lists an example of a task involving the My.Computer.FileSystem.GetDirectories method.
| ParaTo | ConsulteSee |
|---|---|
| Listar subdiretórios com um padrão específicoList subdirectories with a specific pattern | Como localizar subdiretórios com um padrão específico no Visual BasicHow to: Find Subdirectories with a Specific Pattern in Visual Basic |
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.Returns a collection of strings representing the path names of subdirectories within a directory.
public:
static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetDirectories(System::String ^ directory, Microsoft::VisualBasic::FileIO::SearchOption searchType, ... cli::array <System::String ^> ^ wildcards);
public static System.Collections.ObjectModel.ReadOnlyCollection<string> GetDirectories (string directory, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] wildcards);
static member GetDirectories : string * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>
Public Shared 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.Name and path of directory.
- searchType
- SearchOption
Indica se subpastas devem ser incluídas.Whether to include subfolders. O padrão é SearchOption.SearchTopLevelOnly.Default is SearchOption.SearchTopLevelOnly.
- wildcards
- String[]
O padrão ao qual os nomes serão correspondidos.Pattern to match names.
Retornos
Coleção somente leitura dos nomes dos caminhos dos subdiretórios dentro do diretório especificado.Read-only collection of the path names of subdirectories within the specified directory.
Exceções
O caminho não é válido por um dos seguintes motivos: é uma cadeia de tamanho zero, contém apenas espaços em branco, contém caracteres inválidos ou é um caminho de dispositivo (começa com \\.\).The path is not valid for one of the following reasons: it is a zero-length string; it contains only white space; it contains invalid characters; or it is a device path (starts with \\.\).
Um ou mais dos caracteres curinga especificados é Nothing, uma cadeia de caracteres vazia ou contém somente espaços.One or more of the specified wildcard characters is Nothing, an empty string, or contains only spaces.
O diretório especificado não existe.The specified directory does not exist.
O diretório especificado aponta para um arquivo existente.The specified directory points to an existing file.
O caminho excede o tamanho máximo definido pelo sistema.The path exceeds the system-defined maximum length.
Um nome de arquivo ou de diretório no caminho contém dois-pontos (:) ou está em um formato inválido.A file or directory name in the path contains a colon (:) or is in an invalid format.
O usuário não tem as permissões necessárias para exibir o caminho.The user lacks necessary permissions to view the path.
O usuário não tem as permissões necessárias.The user lacks necessary permissions.
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 ao ListBox1 .The following example returns all the directories in the directory structure that contain the word Logs in their names and adds them to ListBox1.
For Each foundDirectory In My.Computer.FileSystem.GetDirectories(
My.Computer.FileSystem.SpecialDirectories.MyDocuments,
True, "*Logs*")
ListBox1.Items.Add(foundDirectory)
Next
Este exemplo requer que você tenha um ListBox nome ListBox1 em seu formulário.This example requires that you have a ListBox named ListBox1 on your form.
Comentários
É possível usar o parâmetro wildcards para especificar um padrão específico.You can use the wildcards parameter to specify a specific pattern. Caso deseje incluir os conteúdos dos subdiretórios na pesquisa, defina o parâmetro searchType para SearchAllSubDirectories.If you would like to include the contents of subdirectories in the search, set the searchType parameter to SearchAllSubDirectories.
Uma coleção vazia será retornada se nenhum diretório correspondente ao padrão especificado for encontrado.An empty collection is returned if no directories matching the specified pattern are found.
A tabela a seguir lista um exemplo de uma tarefa que envolve o My.Computer.FileSystem.GetDirectories método.The following table lists an example of a task involving the My.Computer.FileSystem.GetDirectories method.
| ParaTo | ConsulteSee |
|---|---|
| Listar subdiretórios com um padrão específicoList subdirectories with a specific pattern | Como localizar subdiretórios com um padrão específico no Visual BasicHow to: Find Subdirectories with a Specific Pattern in Visual Basic |