System.IOUtils.TDirectory.GetFiles

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

class function GetFiles(const Path: string): TStringDynArray;
class function GetFiles(const Path: string;
const Predicate: TFilterPredicate): TStringDynArray;
class function GetFiles(const Path, SearchPattern: string): TStringDynArray;
class function GetFiles(const Path, SearchPattern: string;
const Predicate: TFilterPredicate): TStringDynArray;
class function GetFiles(const Path, SearchPattern: string;
const SearchOption: TSearchOption): TStringDynArray; overload; static;
class function GetFiles(const Path, SearchPattern: string;
const SearchOption: TSearchOption;
const Predicate: TFilterPredicate): TStringDynArray; overload; static;
class function GetFiles(const Path: string;
const SearchOption: TSearchOption;
const Predicate: TFilterPredicate): TStringDynArray; overload; static;

C++

static System::DynamicArray<System::UnicodeString> __fastcall GetFiles(const System::UnicodeString Path)/* overload */;
static System::DynamicArray<System::UnicodeString> __fastcall GetFiles(const System::UnicodeString Path, const _di_TFilterPredicate Predicate)/* overload */;
static System::DynamicArray<System::UnicodeString> __fastcall GetFiles(const System::UnicodeString Path, const System::UnicodeString SearchPattern)/* overload */;
static System::DynamicArray<System::UnicodeString> __fastcall GetFiles(const System::UnicodeString Path, const System::UnicodeString SearchPattern, const _di_TFilterPredicate Predicate)/* overload */;
static System::DynamicArray<System::UnicodeString> __fastcall GetFiles(const System::UnicodeString Path, const System::UnicodeString SearchPattern, const TSearchOption SearchOption)/* overload */;
static System::DynamicArray<System::UnicodeString> __fastcall GetFiles(const System::UnicodeString Path, const System::UnicodeString SearchPattern, const TSearchOption SearchOption, const _di_TFilterPredicate Predicate)/* overload */;
static System::DynamicArray<System::UnicodeString> __fastcall GetFiles(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

Gibt eine Liste der Dateien in einem gegebenen Verzeichnis zurück.

Mit GetFiles können Sie eine Liste von Dateien in einem gegebenen Verzeichnis abrufen. Der Rückgabewert von GetFiles ist ein dynamisches String-Array, in dem in jedem Element der Name einer Datei (mit Pfadangabe) gespeichert ist.

Es gibt drei Formen der Methode GetFiles:

  • Die erste Form akzeptiert nur den Pfad des Verzeichnisses, dessen Dateiliste abgerufen werden soll.
  • 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 Abrufen 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 Dateiliste abgerufen werden soll.

SearchPattern

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

SearchOption

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

Predicate

Eine Routine zum Herausfiltern unerwünschter Ergebnisse.


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

Siehe auch

Codebeispiele