FileSystem.GetDirectories Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic.FileIO

Zestaw:

Microsoft.VisualBasic.Core.dll

Zwraca kolekcję ciągów reprezentujących nazwy ścieżek podkatalogów w katalogu.

Przeciążenia

GetDirectories(String)	Zwraca kolekcję ciągów reprezentujących nazwy ścieżek podkatalogów w katalogu.
GetDirectories(String, SearchOption, String[])	Zwraca kolekcję ciągów reprezentujących nazwy ścieżek podkatalogów w katalogu.

GetDirectories(String)

Źródło:

FileSystem.vb

Zwraca kolekcję ciągów reprezentujących nazwy ścieżek podkatalogów w katalogu.

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)

Parametry

directory

String

Nazwa i ścieżka katalogu.

Zwraca

ReadOnlyCollection<String>

Kolekcja tylko do odczytu nazw ścieżek podkatalogów w określonym katalogu.

Wyjątki

ArgumentException

Ścieżka jest nieprawidłowa z jednego z następujących powodów: jest to ciąg o zerowej długości; zawiera tylko białe znaki; zawiera nieprawidłowe znaki; lub jest to ścieżka urządzenia (rozpoczyna się od \\.\).

ArgumentNullException

directory jest lub pusty Nothing ciąg.

DirectoryNotFoundException

Określony katalog nie istnieje.

IOException

Określony katalog wskazuje istniejący plik.

PathTooLongException

Ścieżka przekracza maksymalną długość zdefiniowaną przez system.

NotSupportedException

Nazwa pliku lub katalogu w ścieżce zawiera dwukropek (:) lub jest w nieprawidłowym formacie.

SecurityException

Użytkownik nie ma niezbędnych uprawnień do wyświetlania ścieżki.

UnauthorizedAccessException

Użytkownik nie ma niezbędnych uprawnień.

Przykłady

Poniższy przykład zwraca wszystkie katalogi w strukturze katalogów zawierające wyraz Logs w nazwach i dodaje je do ListBox1elementu .

For Each foundDirectory In My.Computer.FileSystem.GetDirectories(
      My.Computer.FileSystem.SpecialDirectories.MyDocuments,
      True, "*Logs*")

    ListBox1.Items.Add(foundDirectory)
Next

W tym przykładzie jest wymagana ListBox nazwana ListBox1 w formularzu.

Uwagi

W poniższej tabeli wymieniono przykład zadania obejmującego metodę My.Computer.FileSystem.GetDirectories .

Działanie	Zobacz
Wyświetlanie listy podkatalogów z określonym wzorcem	Porady: znajdowanie podkatalogów z określonym wzorcem w Visual Basic

Zobacz też

• SearchOption
• ReadOnlyCollection<T>

GetDirectories(String, SearchOption, String[])

Źródło:

FileSystem.vb

Zwraca kolekcję ciągów reprezentujących nazwy ścieżek podkatalogów w katalogu.

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)

Parametry

directory

String

Nazwa i ścieżka katalogu.

searchType

SearchOption

Czy należy uwzględnić podfoldery. Wartość domyślna to SearchOption.SearchTopLevelOnly.

wildcards

String[]

Wzorzec do dopasowania nazw.

Zwraca

ReadOnlyCollection<String>

Kolekcja tylko do odczytu nazw ścieżek podkatalogów w określonym katalogu.

Wyjątki

ArgumentException

Ścieżka jest nieprawidłowa z jednego z następujących powodów: jest to ciąg o zerowej długości; zawiera tylko białe znaki; zawiera nieprawidłowe znaki; lub jest to ścieżka urządzenia (rozpoczyna się od \\.\).

ArgumentNullException

Co najmniej jeden z określonych symboli wieloznacznych to Nothing, pusty ciąg lub zawiera tylko spacje.

DirectoryNotFoundException

Określony katalog nie istnieje.

IOException

Określony katalog wskazuje istniejący plik.

PathTooLongException

Ścieżka przekracza maksymalną długość zdefiniowaną przez system.

NotSupportedException

Nazwa pliku lub katalogu w ścieżce zawiera dwukropek (:) lub jest w nieprawidłowym formacie.

SecurityException

Użytkownik nie ma niezbędnych uprawnień do wyświetlania ścieżki.

UnauthorizedAccessException

Użytkownik nie ma niezbędnych uprawnień.

Przykłady

Poniższy przykład zwraca wszystkie katalogi w strukturze katalogów zawierające wyraz Logs w nazwach i dodaje je do ListBox1elementu .

For Each foundDirectory In My.Computer.FileSystem.GetDirectories(
      My.Computer.FileSystem.SpecialDirectories.MyDocuments,
      True, "*Logs*")

    ListBox1.Items.Add(foundDirectory)
Next

W tym przykładzie jest wymagana ListBox nazwana ListBox1 w formularzu.

Uwagi

Możesz użyć parametru , wildcards aby określić określony wzorzec. Jeśli chcesz uwzględnić zawartość podkatalogów w wyszukiwaniu, ustaw searchType parametr na SearchAllSubDirectories.

Pusta kolekcja jest zwracana, jeśli nie znaleziono katalogów pasujących do określonego wzorca.

W poniższej tabeli wymieniono przykład zadania obejmującego metodę My.Computer.FileSystem.GetDirectories .

Działanie	Zobacz
Wyświetlanie listy podkatalogów z określonym wzorcem	Porady: znajdowanie podkatalogów z określonym wzorcem w Visual Basic

Zobacz też

• SearchOption
• ReadOnlyCollection<T>