System.IOUtils.TDirectory.GetFiles

De RAD Studio API Documentation
Aller à : navigation, rechercher

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 */;

Propriétés

Type Visibilité  Source Unité  Parent
function public
System.IOUtils.pas
System.IOUtils.hpp
System.IOUtils TDirectory


Description

Renvoie la liste des fichiers d'un répertoire donné.

Utilisez GetFiles pour obtenir la liste des fichiers d'un répertoire donné. La valeur renvoyée par GetFiles est un tableau dynamique de chaînes dans lequel chaque élément stocke le nom d'un fichier (avec son chemin d'accès).

La méthode GetFiles a trois formes :

  • La première forme n'accepte que le chemin du répertoire dont vous souhaitez énumérer les fichiers.
  • La seconde forme inclut un modèle de recherche utilisé lors de la mise en correspondance des noms de fichiers.
  • La troisième forme inclut une option qui spécifie si un mode récursif sera utilisé pendant l'énumération.

Toutes les formes acceptent un paramètre TFilterPredicate facultatif, utilisé pour filtrer les résultats.

Le tableau suivant présente la liste des paramètres attendus par cette méthode.

Nom Signification

Path

Le chemin du répertoire pour lequel les fichiers sont énumérés.

SearchPattern

Le masque est utilisé lors de la mise en correspondance des noms de fichiers (par exemple, "*.exe" trouve tous les fichiers exécutables). Vous pouvez également utiliser MatchesMask lorsque vous appliquez un argument SearchPattern.

SearchOption

Le mode d'énumération du répertoire. Spécifie si vous utilisez le mode d'énumération récursif ou de niveau supérieur.

Predicate

Une routine utilisée pour filtrer les résultats indésirables.


Remarque: GetFiles déclenche une exception si le chemin donné n'est pas correct ou si le répertoire n'existe pas.

Voir aussi

Exemples de code