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::TStringDynArray __fastcall GetFiles(const System::UnicodeString Path)/* overload */;
static System::TStringDynArray __fastcall GetFiles(const System::UnicodeString Path, const _di_TFilterPredicate Predicate)/* overload */;
static System::TStringDynArray __fastcall GetFiles(const System::UnicodeString Path, const System::UnicodeString SearchPattern)/* overload */;
static System::TStringDynArray __fastcall GetFiles(const System::UnicodeString Path, const System::UnicodeString SearchPattern, const _di_TFilterPredicate Predicate)/* overload */;
static System::TStringDynArray __fastcall GetFiles(const System::UnicodeString Path, const System::UnicodeString SearchPattern, const TSearchOption SearchOption)/* overload */;
static System::TStringDynArray __fastcall GetFiles(const System::UnicodeString Path, const System::UnicodeString SearchPattern, const TSearchOption SearchOption, const _di_TFilterPredicate Predicate)/* overload */;
static System::TStringDynArray __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 de retour de GetFiles est un tableau dynamique de chaînes dans lequel chaque élément stocke le nom d'un fichier.

La méthode GetFiles a trois formes :

  • La première forme accepte seulement le chemin du répertoire pour lequel les fichiers sont énumérés.
  • La deuxième forme inclut un modèle de recherche utilisé lors de la correspondance des noms de fichiers.
  • La troisième forme inclut une option spécifiant si un mode récursif est utilisé lors de l'énumération.

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

Le tableau suivant liste les 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 utilisé lors de la correspondance des noms de fichiers (par exemple, "*.exe" correspond à tous les fichiers exécutables).

SearchOption

Le mode d'énumération des répertoires. Spécifie si le mode d'énumération utilisé est récursif ou niveau supérieur.

Predicate

Une routine utilisée pour filtrer les résultats non désirés.



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

Voir aussi