FileSystem.GetFiles Metoda

Definice

Obor názvů:

Microsoft.VisualBasic.FileIO

Sestavení:

Microsoft.VisualBasic.Core.dll

Vrátí kolekci řetězců jen pro čtení představující názvy souborů v adresáři.

Přetížení

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.

GetFiles(String)

Zdroj:

FileSystem.vb

Vrátí kolekci řetězců jen pro čtení představující názvy souborů v adresáři.

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

Adresář, který se má prohledávat.

Návraty

ReadOnlyCollection<String>

Kolekce názvů souborů ze zadaného adresáře jen pro čtení.

Výjimky

ArgumentException

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

ArgumentNullException

directory je Nothing.

DirectoryNotFoundException

Hledaný adresář neexistuje.

IOException

directory odkazuje na existující soubor.

PathTooLongException

Cesta přesahuje systémem definovanou maximální délku.

NotSupportedException

Název souboru nebo adresáře v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.

SecurityException

Uživatel nemá potřebná oprávnění k zobrazení cesty.

UnauthorizedAccessException

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 v jazyce Visual Basic
Vyhledání souborů v adresáři s určitým vzorem	Postupy: Hledání souborů pomocí specifického vzoru v jazyce Visual Basic

Viz také

• ReadOnlyCollection<T>

GetFiles(String, SearchOption, String[])

Zdroj:

FileSystem.vb

Vrátí kolekci řetězců jen pro čtení představující názvy souborů v adresáři.

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

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

ReadOnlyCollection<String>

Kolekce názvů souborů ze zadaného adresáře jen pro čtení.

Výjimky

ArgumentException

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

ArgumentNullException

directory je Nothing.

DirectoryNotFoundException

Hledaný adresář neexistuje.

IOException

directory odkazuje na existující soubor.

PathTooLongException

Cesta přesahuje systémem definovanou maximální délku.

NotSupportedException

Název souboru nebo adresáře v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.

SecurityException

Uživatel nemá potřebná oprávnění k zobrazení cesty.

UnauthorizedAccessException

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 v jazyce Visual Basic
Vyhledání souborů v adresáři s určitým vzorem	Postupy: Hledání souborů pomocí specifického vzoru v jazyce Visual Basic

Viz také

• SearchOption
• ReadOnlyCollection<T>