Udostępnij za pośrednictwem


FileSystemProxy.GetFiles Metoda

Definicja

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

Kolekcja plików tylko do odczytu z określonego katalogu.

Wyjątki

Ś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 \\.\).

directory to Nothing.

Katalog do wyszukiwania nie istnieje.

directory wskazuje istniejący plik.

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

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

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

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

Kolekcja plików tylko do odczytu z określonego katalogu.

Wyjątki

Ś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 \\.\).

directory to Nothing.

Katalog do wyszukiwania nie istnieje.

directory wskazuje istniejący plik.

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

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

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

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