System.IOUtils.TDirectory.GetFiles
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 */;
Inhaltsverzeichnis
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | System.IOUtils.pas System.IOUtils.hpp |
System.IOUtils | TDirectory |
Beschreibung
Gibt eine Liste der Dateien im angegebenen Verzeichnis zurück.
Mit GetFiles können Sie eine Liste der Dateien in einem angegebenen Verzeichnis abrufen. GetFiles gibt ein dynamisches Array mit Strings zurück, in dem jedes Element dem Namen einer Datei entspricht.
GetFiles liegt in drei Syntaxvarianten vor:
- Die erste Variante übernimmt als Parameter nur den Pfad des Verzeichnisses, dessen Dateien aufgelistet werden sollen.
- Bei der zweiten Variante wird ein Suchmuster für Dateinamen angegeben.
- Bei der dritten Variante wird mit einer Option angegeben, ob bei der Auflistung der rekursive Modus verwendet wird.
Alle Varianten akzeptieren den optionalen Parameter TFilterPredicate zum Filtern der Ergebnisse.
Die folgende Tabelle enthält die von dieser Methode erwarteten Parameter.
| Name | Bedeutung |
|---|---|
|
Path |
Der Pfad des Verzeichnisses, für das Dateien aufgelistet werden sollen. |
|
SearchPattern |
Die Maske für die Suche nach Dateinamen (z. B. werden mit "*exe" alle ausführbaren Dateien berücksichtigt). |
|
SearchOption |
Der Auflistungsmodus für das Verzeichnis. Er legt fest, ob die Auflistung nur für die oberste Ebene oder rekursiv erfolgt. |
|
Predicate |
Eine Routine, mit der unerwünschte Ergebnisse herausgefiltert werden können. |
Anmerkung: GetFiles löst eine Exception aus, wenn der angegebene Pfad ungültig oder das Verzeichnis nicht vorhanden ist.
Siehe auch
Codebeispiele