FileSystemProxy.GetFiles Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
Microsoft.VisualBasic.MyServices
Zestaw:
Microsoft.VisualBasic.dll
Zestaw:
Microsoft.VisualBasic.Forms.dll

Zwraca kolekcję ciągów tylko do odczytu reprezentującą nazwy plików w katalogu.

Przeciążenia

GetFiles(String, SearchOption, String[])

Zwraca kolekcję ciągów tylko do odczytu reprezentującą nazwy plików w katalogu.
GetFiles(String)

Zwraca kolekcję ciągów tylko do odczytu reprezentującą nazwy plików w katalogu.

GetFiles(String, SearchOption, String[])

Zwraca kolekcję ciągów tylko do odczytu reprezentującą nazwy plików w katalogu.

public:
 System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory, Microsoft::VisualBasic::FileIO::SearchOption searchType, ... cli::array <System::String ^> ^ wildcards);
public System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] wildcards);
member this.GetFiles : string * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>
Public Function GetFiles (directory As String, searchType As SearchOption, ParamArray wildcards As String()) As ReadOnlyCollection(Of String)

Parametry

directory
String

Katalog do przeszukania.

searchType
SearchOption

Określa, czy należy uwzględnić podfoldery. Wartość domyślna to SearchOption.SearchTopLevelOnly.

wildcards
String[]

Wzorzec do dopasowania.

Zwraca

ReadOnlyCollection<String>

Kolekcja plików tylko do odczytu z określonego 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 to Nothing.

DirectoryNotFoundException

Katalog do wyszukiwania nie istnieje.

IOException

directory 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 pliki w katalogu i dodaje je do ListBox1pliku .

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

Ten przykład wymaga ListBox nazwy ListBox1 w formularzu.

Ten przykład zwraca wszystkie pliki w katalogu z rozszerzeniem .txt i dodaje je do pliku ListBox1.

For Each foundFile As String In My.Computer.FileSystem.GetFiles(
         My.Computer.FileSystem.SpecialDirectories.MyDocuments,
         FileIO.SearchOption.SearchTopLevelOnly, "*.txt")
    ListBox1.Items.Add(foundFile)
Next

Ten przykład wymaga ListBox nazwy ListBox1 w formularzu.

Uwagi

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

W poniższej tabeli wymieniono przykłady zadań obejmujących metodę My.Computer.FileSystem.GetFiles .

Działanie Zobacz
Pobieranie kolekcji plików w katalogu Instrukcje: Pobieranie kolekcji plików z katalogu
Znajdowanie plików z określonym wzorcem w katalogu Instrukcje: Znajdowanie plików z określonym wzorcem

Zobacz też

Dotyczy

GetFiles(String)

Zwraca kolekcję ciągów tylko do odczytu reprezentującą nazwy plików w katalogu.

public:
 System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory);
public System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory);
member this.GetFiles : string -> System.Collections.ObjectModel.ReadOnlyCollection<string>
Public Function GetFiles (directory As String) As ReadOnlyCollection(Of String)

Parametry

directory
String

Katalog do przeszukania.

Zwraca

ReadOnlyCollection<String>

Kolekcja plików tylko do odczytu z określonego 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 to Nothing.

DirectoryNotFoundException

Katalog do wyszukiwania nie istnieje.

IOException

directory 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 pliki w katalogu i dodaje je do ListBox1pliku .

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

Ten przykład wymaga ListBox nazwy ListBox1 w formularzu.

Ten przykład zwraca wszystkie pliki w katalogu z rozszerzeniem .txt i dodaje je do pliku ListBox1.

For Each foundFile As String In My.Computer.FileSystem.GetFiles(
         My.Computer.FileSystem.SpecialDirectories.MyDocuments,
         FileIO.SearchOption.SearchTopLevelOnly, "*.txt")
    ListBox1.Items.Add(foundFile)
Next

Ten przykład wymaga ListBox nazwy ListBox1 w formularzu.

Uwagi

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

W poniższej tabeli wymieniono przykłady zadań obejmujących metodę My.Computer.FileSystem.GetFiles .

Działanie Zobacz
Pobieranie kolekcji plików w katalogu Instrukcje: Pobieranie kolekcji plików z katalogu
Znajdowanie plików z określonym wzorcem w katalogu Instrukcje: Znajdowanie plików z określonym wzorcem

Zobacz też

Dotyczy