Directory.EnumerateFileSystemEntries Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

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

Přetížení

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ýčtovou kolekci 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á 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ý chcete vyhledat. Tento řetězec neodlišuje velká a malá písmena.

Návraty

IEnumerable<String>

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

Výjimky

ArgumentException

.NET Framework a .NET Core verze starší než 2.1: path je řetězec nulové délky, obsahuje pouze prázdné znaky nebo obsahuje neplatné znaky. Pomocí metody se můžete dotazovat 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 kombinace 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 informace o relativní cestě path . Informace o relativní cestě jsou interpretovány jako relativní vzhledem k aktuálnímu pracovnímu adresáři, který můžete určit pomocí GetCurrentDirectory metody .

Metody EnumerateFileSystemEntries a GetFileSystemEntries se liší následujícím způsobem: Při použití EnumerateFileSystemEntriesmůžete spustit výčet kolekce položek před vrácením celé kolekce; při použití GetFileSystemEntriesmusíte počkat na vrácení celé pole položek, abyste měli přístup k poli. Proto při práci s mnoha soubory a adresáři EnumerateFileSystemEntries může být efektivnější.

Vrácená kolekce není uložena do mezipaměti; každé volání GetEnumerator v kolekci zahájí 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ý chcete vyhledat. Tento řetězec neodlišuje velká a malá písmena.

searchPattern

String

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

Návraty

IEnumerable<String>

Výčetná kolekce položek systému souborů v adresáři určeném path a, které odpovídají zadanému vzoru hledání.

Výjimky

ArgumentException

.NET Framework a .NET Core verze starší než 2.1: path je řetězec nulové délky, obsahuje pouze prázdné znaky nebo obsahuje neplatné znaky. Pomocí metody se můžete dotazovat 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 kombinace 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álu a zástupných znaků, ale nepodporuje regulární výrazy. V systému jsou povoleny následující specifikátory zástupných searchPatternznaků.

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

Jiné znaky než zástupný znak jsou literálové znaky. Například searchPattern řetězec "*t" vyhledá všechna jména končící path písmenem "t". Řetězec searchPattern "s*" vyhledá všechna jména začínající path písmenem "s".

Poznámka

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

• Pokud je zadaná přípona přesně tři znaky dlouhá, vrátí metoda soubory s příponami, které začínají určenou příponou. Například "*.xls" vrátí "book.xls" i "book.xlsx".
• Ve všech ostatních případech metoda vrátí 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, vrátí tato metoda pouze soubory, které odpovídají zadané příponě souboru. Například u dvou souborů, "file1.txt" a "file1.txtother" v adresáři, vrátí vyhledávací vzor "soubor?.txt" jen první soubor, zatímco vzor hledání "file*.txt" vrátí oba soubory.

searchPattern nesmí končit dvěma tečkami ("..") nebo obsahovat dvě tečky ("..") za nimi DirectorySeparatorChar nebo AltDirectorySeparatorChar, ani nesmí obsahovat neplatné znaky. Pomocí metody se můžete dotazovat na neplatné znaky GetInvalidPathChars .

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

Metody EnumerateFileSystemEntries a GetFileSystemEntries se liší následujícím způsobem: Při použití EnumerateFileSystemEntriesmůžete spustit výčet kolekce položek před vrácením celé kolekce; při použití GetFileSystemEntriesmusíte počkat na vrácení celé pole položek, abyste měli přístup k poli. Proto při práci s mnoha soubory a adresáři EnumerateFileSystemEntries může být efektivnější.

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

EnumerateFileSystemEntries(String, String, EnumerationOptions)

Zdroj:

Directory.cs

Vrátí výčtovou kolekci 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ý chcete vyhledat. Tento řetězec neodlišuje velká a malá 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ýčetná kolekce položek systému souborů v adresáři určeném nástrojem path, které odpovídají zadanému vzoru hledání a zadaným možnostem výčtu.

Výjimky

ArgumentException

.NET Framework a .NET Core verze starší než 2.1: path je řetězec nulové délky, obsahuje pouze prázdné znaky nebo obsahuje neplatné znaky. Pomocí metody se můžete dotazovat 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 kombinace 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álu a zástupných znaků, ale nepodporuje regulární výrazy. V systému jsou povoleny následující specifikátory zástupných searchPatternznaků.

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

Jiné znaky než zástupný znak jsou literálové znaky. Například searchPattern řetězec "*t" vyhledá všechna jména končící path písmenem "t". Řetězec searchPattern "s*" vyhledá všechna jména začínající path písmenem "s".

Poznámka

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

• Pokud je zadaná přípona přesně tři znaky dlouhá, vrátí metoda soubory s příponami, které začínají určenou příponou. Například "*.xls" vrátí "book.xls" i "book.xlsx".
• Ve všech ostatních případech metoda vrátí 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, vrátí tato metoda pouze soubory, které odpovídají zadané příponě souboru. Například u dvou souborů, "file1.txt" a "file1.txtother" v adresáři, vrátí vyhledávací vzor "soubor?.txt" jen první soubor, zatímco vzor hledání "file*.txt" vrátí oba soubory.

searchPattern nesmí končit dvěma tečkami ("..") nebo obsahovat dvě tečky ("..") za nimi DirectorySeparatorChar nebo AltDirectorySeparatorChar, ani nesmí obsahovat neplatné znaky. Pomocí metody se můžete dotazovat na neplatné znaky GetInvalidPathChars .

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

Metody EnumerateFileSystemEntries a GetFileSystemEntries se liší následujícím způsobem: Při použití EnumerateFileSystemEntriesmůžete spustit výčet kolekce položek před vrácením celé kolekce; při použití GetFileSystemEntriesmusíte počkat na vrácení celé pole položek, abyste měli přístup k poli. Proto při práci s mnoha soubory a adresáři EnumerateFileSystemEntries může být efektivnější.

Vrácená kolekce není uložena do mezipaměti; každé volání GetEnumerator v kolekci zahájí 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á 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ý chcete vyhledat. Tento řetězec neodlišuje velká a malá písmena.

searchPattern

String

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

searchOption

SearchOption

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

Návraty

IEnumerable<String>

Výčetná kolekce položek systému souborů v adresáři určeném a path , které odpovídají zadanému vzoru a možnosti hledání.

Výjimky

ArgumentException

.NET Framework a .NET Core verze starší než 2.1: path je řetězec nulové délky, obsahuje pouze prázdné znaky nebo obsahuje neplatné znaky. Pomocí metody se můžete dotazovat 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 kombinace 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álu a zástupných znaků, ale nepodporuje regulární výrazy. V systému jsou povoleny následující specifikátory zástupných searchPatternznaků.

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

Jiné znaky než zástupný znak jsou literálové znaky. Například searchPattern řetězec "*t" vyhledá všechna jména končící path písmenem "t". Řetězec searchPattern "s*" vyhledá všechna jména začínající path písmenem "s".

Poznámka

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

• Pokud je zadaná přípona přesně tři znaky dlouhá, vrátí metoda soubory s příponami, které začínají určenou příponou. Například "*.xls" vrátí "book.xls" i "book.xlsx".
• Ve všech ostatních případech metoda vrátí 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, vrátí tato metoda pouze soubory, které odpovídají zadané příponě souboru. Například u dvou souborů, "file1.txt" a "file1.txtother" v adresáři, vrátí vyhledávací vzor "soubor?.txt" jen první soubor, zatímco vzor hledání "file*.txt" vrátí oba soubory.

searchPattern nesmí končit dvěma tečkami ("..") nebo obsahovat dvě tečky ("..") za nimi DirectorySeparatorChar nebo AltDirectorySeparatorChar, ani nesmí obsahovat neplatné znaky. Pomocí metody se můžete dotazovat na neplatné znaky GetInvalidPathChars .

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

Metody EnumerateFileSystemEntries a GetFileSystemEntries se liší následujícím způsobem: Při použití EnumerateFileSystemEntriesmůžete spustit výčet kolekce položek před vrácením celé kolekce; při použití GetFileSystemEntriesmusíte počkat na vrácení celé pole položek, abyste měli přístup k poli. Proto při práci s mnoha soubory a adresáři EnumerateFileSystemEntries může být efektivnější.

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