FileSystemProxy.GetFiles Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vrátí kolekci řetězců jen pro čtení představující názvy souborů v adresáři.
Přetížení
GetFiles(String, SearchOption, String[]) |
Vrátí kolekci řetězců jen pro čtení představující názvy souborů v adresáři. |
GetFiles(String) |
Vrátí kolekci řetězců jen pro čtení představující názvy souborů v adresáři. |
GetFiles(String, SearchOption, String[])
Vrátí kolekci řetězců jen pro čtení představující názvy souborů v adresáři.
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
Adresář, který se má prohledávat.
- searchType
- SearchOption
Jestli se mají zahrnout podsložky. Výchozí je SearchOption.SearchTopLevelOnly
.
- wildcards
- String[]
Vzor, který se má shodovat.
Návraty
Kolekce názvů souborů ze zadaného adresáře jen pro čtení.
Výjimky
Cesta není platná z jednoho z následujících důvodů: jedná se o řetězec nulové délky; obsahuje pouze prázdné znaky; obsahuje neplatné znaky; nebo se jedná o cestu k zařízení (začíná na \\.\).
directory
je Nothing
.
Hledaný adresář neexistuje.
directory
odkazuje na existující soubor.
Cesta přesahuje systémem definovanou maximální délku.
Název souboru nebo adresáře v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.
Uživatel nemá potřebná oprávnění k zobrazení cesty.
Uživatel nemá potřebná oprávnění.
Příklady
Následující příklad vrátí všechny soubory v adresáři a přidá je do ListBox1
.
For Each foundFile In My.Computer.FileSystem.GetFiles(
My.Computer.FileSystem.SpecialDirectories.MyDocuments)
ListBox1.Items.Add(foundFile)
Next
Tento příklad vyžaduje, abyste ve formuláři měli ListBox
název ListBox1
.
Tento příklad vrátí všechny soubory v adresáři s příponou .txt
a přidá je do 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
Tento příklad vyžaduje, abyste ve formuláři měli ListBox
název ListBox1
.
Poznámky
Pokud nejsou nalezeny žádné soubory odpovídající zadanému vzoru, vrátí se prázdná kolekce.
Následující tabulka uvádí příklady úloh zahrnujících metodu My.Computer.FileSystem.GetFiles
.
Záměr | Seznamte se s |
---|---|
Získání kolekce souborů v adresáři | Postupy: Získání kolekce souborů z adresáře |
Vyhledání souborů v adresáři s určitým vzorem | Postupy: Hledání souborů pomocí specifického vzoru |
Viz také
- SearchOption
- ReadOnlyCollection<T>
- Objekty (Visual Basic)
- Postupy: Hledání souborů pomocí specifického vzoru v jazyce Visual Basic
- Postupy: Získání kolekce souborů z adresáře v jazyce Visual Basic
Platí pro
GetFiles(String)
Vrátí kolekci řetězců jen pro čtení představující názvy souborů v adresáři.
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
Adresář, který se má prohledávat.
Návraty
Kolekce názvů souborů ze zadaného adresáře jen pro čtení.
Výjimky
Cesta není platná z jednoho z následujících důvodů: jedná se o řetězec nulové délky; obsahuje pouze prázdné znaky; obsahuje neplatné znaky; nebo se jedná o cestu k zařízení (začíná na \\.\).
directory
je Nothing
.
Hledaný adresář neexistuje.
directory
odkazuje na existující soubor.
Cesta přesahuje systémem definovanou maximální délku.
Název souboru nebo adresáře v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.
Uživatel nemá potřebná oprávnění k zobrazení cesty.
Uživatel nemá potřebná oprávnění.
Příklady
Následující příklad vrátí všechny soubory v adresáři a přidá je do ListBox1
.
For Each foundFile In My.Computer.FileSystem.GetFiles(
My.Computer.FileSystem.SpecialDirectories.MyDocuments)
ListBox1.Items.Add(foundFile)
Next
Tento příklad vyžaduje, abyste ve formuláři měli ListBox
název ListBox1
.
Tento příklad vrátí všechny soubory v adresáři s příponou .txt
a přidá je do 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
Tento příklad vyžaduje, abyste ve formuláři měli ListBox
název ListBox1
.
Poznámky
Pokud nejsou nalezeny žádné soubory odpovídající zadanému vzoru, vrátí se prázdná kolekce.
Následující tabulka uvádí příklady úloh zahrnujících metodu My.Computer.FileSystem.GetFiles
.
Záměr | Seznamte se s |
---|---|
Získání kolekce souborů v adresáři | Postupy: Získání kolekce souborů z adresáře |
Vyhledání souborů v adresáři s určitým vzorem | Postupy: Hledání souborů pomocí specifického vzoru |
Viz také
- ReadOnlyCollection<T>
- Objekty (Visual Basic)
- Postupy: Hledání souborů pomocí specifického vzoru v jazyce Visual Basic
- Postupy: Získání kolekce souborů z adresáře v jazyce Visual Basic