FileSystemProxy.GetFiles Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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ż
- SearchOption
- ReadOnlyCollection<T>
- Obiekty (Visual Basic)
- Porady: znajdowanie plików z określonym wzorcem w Visual Basic
- Porady: pobieranie kolekcji plików z katalogu w Visual Basic
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ż
- ReadOnlyCollection<T>
- Obiekty (Visual Basic)
- Porady: znajdowanie plików z określonym wzorcem w Visual Basic
- Porady: pobieranie kolekcji plików z katalogu w Visual Basic