System.IOUtils.TDirectory.GetFilesEnumerator

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

class function GetFilesEnumerator(const Path, SearchPattern: string;
const SearchOption: TSearchOption; const Predicate: TFilterPredicate;
const MatchCasing: TMatchCasing = TMatchCasing.mcPlatformDefault): IEnumerable<string>; overload; static;
class function GetFilesEnumerator(const Path: string): IEnumerable<string>;
class function GetFilesEnumerator(const Path: string;
const Predicate: TFilterPredicate): IEnumerable<string>;
class function GetFilesEnumerator(const Path, SearchPattern: string): IEnumerable<string>;
class function GetFilesEnumerator(const Path, SearchPattern: string;
const Predicate: TFilterPredicate): IEnumerable<string>;
class function GetFilesEnumerator(const Path, SearchPattern: string;
const SearchOption: TSearchOption): IEnumerable<string>; overload; inline; static;
class function GetFilesEnumerator(const Path: string;
const SearchOption: TSearchOption;
const Predicate: TFilterPredicate): IEnumerable<string>; overload; inline; static;

C++

static System::DelphiInterface<System::IEnumerable__1<System::UnicodeString> > __fastcall GetFilesEnumerator(const System::UnicodeString Path, const System::UnicodeString SearchPattern, const TSearchOption SearchOption, const _di_TFilterPredicate Predicate, const TMatchCasing MatchCasing = (TMatchCasing)(0x0))/* overload */;
static System::DelphiInterface<System::IEnumerable__1<System::UnicodeString> > __fastcall GetFilesEnumerator(const System::UnicodeString Path)/* overload */;
static System::DelphiInterface<System::IEnumerable__1<System::UnicodeString> > __fastcall GetFilesEnumerator(const System::UnicodeString Path, const _di_TFilterPredicate Predicate)/* overload */;
static System::DelphiInterface<System::IEnumerable__1<System::UnicodeString> > __fastcall GetFilesEnumerator(const System::UnicodeString Path, const System::UnicodeString SearchPattern)/* overload */;
static System::DelphiInterface<System::IEnumerable__1<System::UnicodeString> > __fastcall GetFilesEnumerator(const System::UnicodeString Path, const System::UnicodeString SearchPattern, const _di_TFilterPredicate Predicate)/* overload */;
static System::DelphiInterface<System::IEnumerable__1<System::UnicodeString> > __fastcall GetFilesEnumerator(const System::UnicodeString Path, const System::UnicodeString SearchPattern, const TSearchOption SearchOption)/* overload */;
static System::DelphiInterface<System::IEnumerable__1<System::UnicodeString> > __fastcall GetFilesEnumerator(const System::UnicodeString Path, const TSearchOption SearchOption, const _di_TFilterPredicate Predicate)/* overload */;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.IOUtils.pas
System.IOUtils.hpp
System.IOUtils TDirectory


Beschreibung

Listet die Dateien in einem gegebenen Verzeichnis auf.

Verwenden Sie GetFilesEnumerator, um ein Enumerator-Objekt abzurufen, das die Dateien in einem gegebenen Verzeichnis zurückgibt.

Es gibt drei Formen der Methode GetFilesEnumerator:

  • Die erste Form akzeptiert nur den Pfad des Verzeichnisses, dessen Dateien abgerufen werden sollen.
  • Die zweite Form enthält ein Suchmuster, für die Suche nach übereinstimmenden Dateinamen.
  • Die dritte Form enthält eine Option, die angibt, ob beim Auflisten der rekursive Modus verwendet werden soll.

Alle Formen akzeptieren den optionalen Parameter TFilterPredicate zum Filtern der Ergebnisse.

In der folgenden Tabelle sind die von dieser Methode erwarteten Parameter aufgeführt.

Name Bedeutung

Path

Der Pfad des Verzeichnisses, dessen Dateien abgerufen werden soll.

SearchPattern

Die Maske wird für den Abgleich von Dateinamen verwendet (z. B. werden mit "*.exe" alle ausführbaren Dateien gefunden). Sie können MatchesMask auch mit dem Argument SearchPattern verwenden.

SearchOption

Der Auflistungsmodus des Verzeichnisses. Gibt an, ob der Auflistungsmodus der obersten Ebene oder der rekursive Modus verwendet werden soll.

Predicate

Eine Routine zum Herausfiltern unerwünschter Ergebnisse.


Hinweis: GetFilesEnumerator löst eine Exception aus, wenn der gegebene Pfad ungültig ist oder das Verzeichnis nicht vorhanden ist.

Siehe auch

Codebeispiele