Directory.EnumerateFileSystemEntries Metoda

Definice

Obor názvů:

System.IO

Sestavení:

netstandard.dll, System.Runtime.dll

Vrátí výčet kolekcí položek systému souborů, které splňují zadaná kritéria.

Přetížení

Name	Description
EnumerateFileSystemEntries(String)	Vrátí výčet kolekcí názvů souborů a názvů adresářů v zadané cestě.
EnumerateFileSystemEntries(String, String)	Vrátí výčet kolekcí názvů souborů a názvů adresářů, které odpovídají vzoru hledání v zadané cestě.
EnumerateFileSystemEntries(String, String, EnumerationOptions)	Vrátí výčet kolekcí názvů souborů a názvů adresářů, které odpovídají vzoru hledání a možnostem výčtu v zadané cestě.
EnumerateFileSystemEntries(String, String, SearchOption)	Vrátí výčet kolekcí názvů souborů a názvů adresářů, které odpovídají vzoru hledání v zadané cestě, a volitelně prohledává podadresáře.

EnumerateFileSystemEntries(String)

Zdroj:

Directory.cs

Vrátí výčet kolekcí názvů souborů a názvů adresářů v zadané cestě.

public:
 static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path);

public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries(string path);

static member EnumerateFileSystemEntries : string -> seq<string>

Public Shared Function EnumerateFileSystemEntries (path As String) As IEnumerable(Of String)

Parametry

path

String

Relativní nebo absolutní cesta k adresáři, který se má prohledávat. Tento řetězec nerozlišuje malá a velká písmena.

Návraty

IEnumerable<String>

Výčet kolekcí položek systému souborů v adresáři určeném nástrojem path.

Výjimky

ArgumentException

.NET Framework a verze .NET Core starší než 2.1: path je řetězec nulové délky, obsahuje pouze prázdné znaky nebo obsahuje neplatné znaky. Pomocí metody můžete zadat dotaz na neplatné znaky GetInvalidPathChars() .

ArgumentNullException

path je null.

DirectoryNotFoundException

path je neplatný, například odkaz na nenamapovanou jednotku.

IOException

path je název souboru.

PathTooLongException

Zadaná cesta, název souboru nebo kombinovaná hodnota překračuje maximální délku definovanou systémem.

SecurityException

Volající nemá požadované oprávnění.

UnauthorizedAccessException

Volající nemá požadované oprávnění.

Poznámky

Pomocí parametru můžete zadat relativní informace o cestě path . Relativní informace o cestě se interpretují jako relativní vzhledem k aktuálnímu pracovnímu adresáři, který můžete určit pomocí GetCurrentDirectory metody.

Tyto EnumerateFileSystemEntries metody se GetFileSystemEntries liší takto: Při použití EnumerateFileSystemEntriesmůžete začít vytvářet výčet položek před vrácením celé kolekce; při použití GetFileSystemEntriesmusíte počkat na vrácení celé pole položek, než budete mít přístup k matici. Proto při práci s mnoha soubory a adresáři EnumerateFileSystemEntries může být efektivnější.

Vrácená kolekce není uložena v mezipaměti; každé volání GetEnumerator kolekce spustí nový výčet.

EnumerateFileSystemEntries(String, String)

Zdroj:

Directory.cs

Vrátí výčet kolekcí názvů souborů a názvů adresářů, které odpovídají vzoru hledání v zadané cestě.

public:
 static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path, System::String ^ searchPattern);

public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries(string path, string searchPattern);

static member EnumerateFileSystemEntries : string * string -> seq<string>

Public Shared Function EnumerateFileSystemEntries (path As String, searchPattern As String) As IEnumerable(Of String)

Parametry

path

String

Relativní nebo absolutní cesta k adresáři, který se má prohledávat. Tento řetězec nerozlišuje malá a velká písmena.

searchPattern

String

Hledaný řetězec, který se má shodovat s názvy položek systému souborů v path. Tento parametr může obsahovat kombinaci platných znaků literálu a zástupných znaků (* a ?), ale nepodporuje regulární výrazy.

Návraty

IEnumerable<String>

Výčet kolekcí položek systému souborů v adresáři určeném path podle zadaného vzoru hledání.

Výjimky

ArgumentException

.NET Framework a verze .NET Core starší než 2.1: path je řetězec nulové délky, obsahuje pouze prázdné znaky nebo obsahuje neplatné znaky. Pomocí metody můžete zadat dotaz na neplatné znaky GetInvalidPathChars() .

nebo

searchPattern neobsahuje platný vzor.

ArgumentNullException

path je null.

nebo

searchPattern je null.

DirectoryNotFoundException

path je neplatný, například odkaz na nenamapovanou jednotku.

IOException

path je název souboru.

PathTooLongException

Zadaná cesta, název souboru nebo kombinovaná hodnota překračuje maximální délku definovanou systémem.

SecurityException

Volající nemá požadované oprávnění.

UnauthorizedAccessException

Volající nemá požadované oprávnění.

Poznámky

searchPattern může být kombinací literálů a zástupných znaků, ale nepodporuje regulární výrazy. Následující specifikátory zástupných znaků jsou povoleny v searchPattern.

Specifikátor zástupných znaků	Shody
* (hvězdička)	V této pozici je nula nebo více znaků.
? (otazník)	Přesně jeden znak v této pozici.

Jiné znaky než zástupné znaky jsou literální znaky. Například searchPattern řetězec "*t" vyhledá všechny názvy path končící písmenem "t". Řetězec searchPattern "s*" vyhledá všechny názvy začínající path písmenem "s".

Note

Pokud použijete zástupný znak hvězdičky v příkladu searchPattern "*.txt", počet znaků v zadaném rozšíření ovlivní hledání následujícím způsobem:

• Pokud je zadané rozšíření přesně tři znaky dlouhé, metoda vrátí soubory s příponami, které začínají zadanou příponou. Například "*.xls" vrátíbook.xls" a "book.xlsx".
• Ve všech ostatních případech vrátí metoda soubory, které přesně odpovídají zadané příponě. Například "*.ai" vrátí "file.ai", ale ne "file.aif".

Pokud použijete zástupný znak otazníku, tato metoda vrátí pouze soubory, které odpovídají zadané příponě souboru. Například vzhledem k dvěma souborům, "file1.txt" a "file1.txtother" v adresáři, vzor hledání "soubor?.txt" vrátí pouze první soubor, zatímco hledaný vzor "file*.txt" vrátí oba soubory.

searchPattern nemůže končit dvěma tečkami (".") nebo obsahovat dvě tečky (..) následované DirectorySeparatorChar nebo AltDirectorySeparatorChar, ani nesmí obsahovat neplatné znaky. Pomocí metody můžete zadat dotaz na neplatné znaky GetInvalidPathChars .

Pomocí parametru můžete zadat relativní informace o cestě path . Relativní informace o cestě se interpretují jako relativní vzhledem k aktuálnímu pracovnímu adresáři, který můžete určit pomocí GetCurrentDirectory metody.

Tyto EnumerateFileSystemEntries metody se GetFileSystemEntries liší takto: Při použití EnumerateFileSystemEntriesmůžete začít vytvářet výčet položek před vrácením celé kolekce; při použití GetFileSystemEntriesmusíte počkat na vrácení celé pole položek, než budete mít přístup k matici. Proto při práci s mnoha soubory a adresáři EnumerateFileSystemEntries může být efektivnější.

Vrácená kolekce není uložena v mezipaměti; každé volání GetEnumerator kolekce spustí nový výčet.

EnumerateFileSystemEntries(String, String, EnumerationOptions)

Zdroj:

Directory.cs

Vrátí výčet kolekcí názvů souborů a názvů adresářů, které odpovídají vzoru hledání a možnostem výčtu v zadané cestě.

public:
 static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path, System::String ^ searchPattern, System::IO::EnumerationOptions ^ enumerationOptions);

public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries(string path, string searchPattern, System.IO.EnumerationOptions enumerationOptions);

static member EnumerateFileSystemEntries : string * string * System.IO.EnumerationOptions -> seq<string>

Public Shared Function EnumerateFileSystemEntries (path As String, searchPattern As String, enumerationOptions As EnumerationOptions) As IEnumerable(Of String)

Parametry

path

String

Relativní nebo absolutní cesta k adresáři, který se má prohledávat. Tento řetězec nerozlišuje malá a velká písmena.

searchPattern

String

Hledaný řetězec, který se má shodovat s názvy souborů a adresářů v pathsouboru . Tento parametr může obsahovat kombinaci platných literálů a zástupných znaků, ale nepodporuje regulární výrazy.

enumerationOptions

EnumerationOptions

Objekt, který popisuje konfiguraci vyhledávání a výčtu, která se má použít.

Návraty

IEnumerable<String>

Výčet položek systému souborů v adresáři určeném pathnástrojem , který odpovídá zadanému vzoru hledání a zadaným možnostem výčtu.

Výjimky

ArgumentException

.NET Framework a verze .NET Core starší než 2.1: path je řetězec nulové délky, obsahuje pouze prázdné znaky nebo obsahuje neplatné znaky. Pomocí metody můžete zadat dotaz na neplatné znaky GetInvalidPathChars() .

nebo

searchPattern neobsahuje platný vzor.

ArgumentNullException

path je null.

nebo

searchPattern je null.

DirectoryNotFoundException

path je neplatný, například odkaz na nenamapovanou jednotku.

IOException

path je název souboru.

PathTooLongException

Zadaná cesta, název souboru nebo kombinovaná hodnota překračuje maximální délku definovanou systémem.

SecurityException

Volající nemá požadované oprávnění.

UnauthorizedAccessException

Volající nemá požadované oprávnění.

Poznámky

searchPattern může být kombinací literálů a zástupných znaků, ale nepodporuje regulární výrazy. Následující specifikátory zástupných znaků jsou povoleny v searchPattern.

Specifikátor zástupných znaků	Shody
* (hvězdička)	V této pozici je nula nebo více znaků.
? (otazník)	Přesně jeden znak v této pozici.

Jiné znaky než zástupné znaky jsou literální znaky. Například searchPattern řetězec "*t" vyhledá všechny názvy path končící písmenem "t". Řetězec searchPattern "s*" vyhledá všechny názvy začínající path písmenem "s".

Note

Pokud použijete zástupný znak hvězdičky v příkladu searchPattern "*.txt", počet znaků v zadaném rozšíření ovlivní hledání následujícím způsobem:

• Pokud je zadané rozšíření přesně tři znaky dlouhé, metoda vrátí soubory s příponami, které začínají zadanou příponou. Například "*.xls" vrátíbook.xls" a "book.xlsx".
• Ve všech ostatních případech vrátí metoda soubory, které přesně odpovídají zadané příponě. Například "*.ai" vrátí "file.ai", ale ne "file.aif".

Pokud použijete zástupný znak otazníku, tato metoda vrátí pouze soubory, které odpovídají zadané příponě souboru. Například vzhledem k dvěma souborům, "file1.txt" a "file1.txtother" v adresáři, vzor hledání "soubor?.txt" vrátí pouze první soubor, zatímco hledaný vzor "file*.txt" vrátí oba soubory.

searchPattern nemůže končit dvěma tečkami (".") nebo obsahovat dvě tečky (..) následované DirectorySeparatorChar nebo AltDirectorySeparatorChar, ani nesmí obsahovat neplatné znaky. Pomocí metody můžete zadat dotaz na neplatné znaky GetInvalidPathChars .

Pomocí parametru můžete zadat relativní informace o cestě path . Relativní informace o cestě se interpretují jako relativní vzhledem k aktuálnímu pracovnímu adresáři, který můžete určit pomocí GetCurrentDirectory metody.

Tyto EnumerateFileSystemEntries metody se GetFileSystemEntries liší takto: Při použití EnumerateFileSystemEntriesmůžete začít vytvářet výčet položek před vrácením celé kolekce; při použití GetFileSystemEntriesmusíte počkat na vrácení celé pole položek, než budete mít přístup k matici. Proto při práci s mnoha soubory a adresáři EnumerateFileSystemEntries může být efektivnější.

Vrácená kolekce není uložena v mezipaměti; každé volání GetEnumerator kolekce spustí nový výčet.

EnumerateFileSystemEntries(String, String, SearchOption)

Zdroj:

Directory.cs

Vrátí výčet kolekcí názvů souborů a názvů adresářů, které odpovídají vzoru hledání v zadané cestě, a volitelně prohledává podadresáře.

public:
 static System::Collections::Generic::IEnumerable<System::String ^> ^ EnumerateFileSystemEntries(System::String ^ path, System::String ^ searchPattern, System::IO::SearchOption searchOption);

public static System.Collections.Generic.IEnumerable<string> EnumerateFileSystemEntries(string path, string searchPattern, System.IO.SearchOption searchOption);

static member EnumerateFileSystemEntries : string * string * System.IO.SearchOption -> seq<string>

Public Shared Function EnumerateFileSystemEntries (path As String, searchPattern As String, searchOption As SearchOption) As IEnumerable(Of String)

Parametry

path

String

Relativní nebo absolutní cesta k adresáři, který se má prohledávat. Tento řetězec nerozlišuje malá a velká písmena.

searchPattern

String

Hledaný řetězec, který se má shodovat s položkami systému souborů v path. Tento parametr může obsahovat kombinaci platných znaků literálu a zástupných znaků (* a ?), ale nepodporuje regulární výrazy.

searchOption

SearchOption

Jedna z hodnot výčtu, která určuje, zda by operace vyhledávání měla obsahovat pouze aktuální adresář nebo by měla obsahovat všechny podadresáře. Výchozí hodnota je TopDirectoryOnly.

Návraty

IEnumerable<String>

Výčet kolekcí položek systému souborů v adresáři určeném path podle zadaného vzoru hledání a možnosti.

Výjimky

ArgumentException

.NET Framework a verze .NET Core starší než 2.1: path je řetězec nulové délky, obsahuje pouze prázdné znaky nebo obsahuje neplatné znaky. Pomocí metody můžete zadat dotaz na neplatné znaky GetInvalidPathChars() .

nebo

searchPattern neobsahuje platný vzor.

ArgumentNullException

path je null.

nebo

searchPattern je null.

ArgumentOutOfRangeException

searchOption není platná SearchOption hodnota.

DirectoryNotFoundException

path je neplatný, například odkaz na nenamapovanou jednotku.

IOException

path je název souboru.

PathTooLongException

Zadaná cesta, název souboru nebo kombinovaná hodnota překračuje maximální délku definovanou systémem.

SecurityException

Volající nemá požadované oprávnění.

UnauthorizedAccessException

Volající nemá požadované oprávnění.

Poznámky

searchPattern může být kombinací literálů a zástupných znaků, ale nepodporuje regulární výrazy. Následující specifikátory zástupných znaků jsou povoleny v searchPattern.

Specifikátor zástupných znaků	Shody
* (hvězdička)	V této pozici je nula nebo více znaků.
? (otazník)	Přesně jeden znak v této pozici.

Jiné znaky než zástupné znaky jsou literální znaky. Například searchPattern řetězec "*t" vyhledá všechny názvy path končící písmenem "t". Řetězec searchPattern "s*" vyhledá všechny názvy začínající path písmenem "s".

Note

Pokud použijete zástupný znak hvězdičky v příkladu searchPattern "*.txt", počet znaků v zadaném rozšíření ovlivní hledání následujícím způsobem:

• Pokud je zadané rozšíření přesně tři znaky dlouhé, metoda vrátí soubory s příponami, které začínají zadanou příponou. Například "*.xls" vrátíbook.xls" a "book.xlsx".
• Ve všech ostatních případech vrátí metoda soubory, které přesně odpovídají zadané příponě. Například "*.ai" vrátí "file.ai", ale ne "file.aif".

Pokud použijete zástupný znak otazníku, tato metoda vrátí pouze soubory, které odpovídají zadané příponě souboru. Například vzhledem k dvěma souborům, "file1.txt" a "file1.txtother" v adresáři, vzor hledání "soubor?.txt" vrátí pouze první soubor, zatímco hledaný vzor "file*.txt" vrátí oba soubory.

searchPattern nemůže končit dvěma tečkami (".") nebo obsahovat dvě tečky (..) následované DirectorySeparatorChar nebo AltDirectorySeparatorChar, ani nesmí obsahovat neplatné znaky. Pomocí metody můžete zadat dotaz na neplatné znaky GetInvalidPathChars .

Pomocí parametru můžete zadat relativní informace o cestě path . Relativní informace o cestě se interpretují jako relativní vzhledem k aktuálnímu pracovnímu adresáři, který můžete určit pomocí GetCurrentDirectory metody.

Tyto EnumerateFileSystemEntries metody se GetFileSystemEntries liší takto: Při použití EnumerateFileSystemEntriesmůžete začít vytvářet výčet položek před vrácením celé kolekce; při použití GetFileSystemEntriesmusíte počkat na vrácení celé pole položek, než budete mít přístup k matici. Proto při práci s mnoha soubory a adresáři EnumerateFileSystemEntries může být efektivnější.

Vrácená kolekce není uložena v mezipaměti; každé volání GetEnumerator kolekce spustí nový výčet.