Porady: pobieranie kolekcji plików w katalogu w Visual Basic

Przeciążenia FileSystem.GetFiles metody zwracają kolekcję ciągów tylko do odczytu reprezentującą nazwy plików w katalogu:

• Użyj przeciążonej wersji GetFiles(String) do prostego wyszukiwania plików w określonym katalogu bez przeszukiwania podkatalogów.

• Użyj przeciążenia GetFiles(String, SearchOption, String[]), aby określić dodatkowe opcje dla wyszukiwania. Możesz użyć parametru wildCards , aby określić wzorzec wyszukiwania. Aby uwzględnić podkatalogi w wyszukiwaniu, ustaw parametr searchType na SearchOption.SearchAllSubDirectories.

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

Aby wyświetlić listę plików w katalogu

• Użyj jednego z FileSystem.GetFiles przeciążeń metody, podając nazwę i ścieżkę katalogu, który ma być przeszukiwany w parametrze directory. Poniższy przykład zwraca wszystkie pliki w katalogu i dodaje je do ListBox1.

  For Each foundFile As String In My.Computer.FileSystem.GetFiles(
    My.Computer.FileSystem.SpecialDirectories.MyDocuments)
  
      listBox1.Items.Add(foundFile)
  Next
  

Niezawodne programowanie

Następujące warunki mogą spowodować wyjątek:

• Ś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 ścieżką urządzenia (zaczyna się od \\.\) (ArgumentException).

• Ścieżka jest nieprawidłowa, ponieważ jest Nothing (ArgumentNullException).

• directory nie istnieje (DirectoryNotFoundException).

• directory wskazuje istniejący plik (IOException).

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

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

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

• Użytkownik nie ma niezbędnych uprawnień (UnauthorizedAccessException).

Zobacz także

• GetFiles
• Instrukcje: znajdowanie plików z określonym wzorcem
• Instrukcje: znajdowanie podkatalogów z określonym wzorcem