FileSystem.GetFiles Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic.FileIO

Zestaw:

Microsoft.VisualBasic.Core.dll

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

Przeciążenia

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.

GetFiles(String)

Źródło:

FileSystem.vb

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

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory);

public static System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory);

static member GetFiles : string -> System.Collections.ObjectModel.ReadOnlyCollection<string>

Public Shared 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 ListBox1elementu .

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

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

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

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

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

Uwagi

Pusta kolekcja jest zwracana, jeśli nie znaleziono żadnych 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	Porady: pobieranie kolekcji plików z katalogu w Visual Basic
Znajdowanie plików o określonym wzorcu w katalogu	Porady: znajdowanie plików z określonym wzorcem w Visual Basic

Zobacz też

• ReadOnlyCollection<T>

GetFiles(String, SearchOption, String[])

Źródło:

FileSystem.vb

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

public:
 static System::Collections::ObjectModel::ReadOnlyCollection<System::String ^> ^ GetFiles(System::String ^ directory, Microsoft::VisualBasic::FileIO::SearchOption searchType, ... cli::array <System::String ^> ^ wildcards);

public static System.Collections.ObjectModel.ReadOnlyCollection<string> GetFiles (string directory, Microsoft.VisualBasic.FileIO.SearchOption searchType, params string[] wildcards);

static member GetFiles : string * Microsoft.VisualBasic.FileIO.SearchOption * string[] -> System.Collections.ObjectModel.ReadOnlyCollection<string>

Public Shared Function GetFiles (directory As String, searchType As SearchOption, ParamArray wildcards As String()) As ReadOnlyCollection(Of String)

Parametry

directory

String

Katalog do przeszukania.

searchType

SearchOption

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 ListBox1elementu .

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

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

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

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

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

Uwagi

Pusta kolekcja jest zwracana, jeśli nie znaleziono żadnych 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	Porady: pobieranie kolekcji plików z katalogu w Visual Basic
Znajdowanie plików o określonym wzorcu w katalogu	Porady: znajdowanie plików z określonym wzorcem w Visual Basic

Zobacz też

• SearchOption
• ReadOnlyCollection<T>