System.IOUtils.TFile.Replace
Delphi
class procedure Replace(const SourceFileName, DestinationFileName, DestinationBackupFileName: string); overload; {$IFDEF MSWINDOWS}inline; {$ENDIF} static;
class procedure Replace(SourceFileName, DestinationFileName, DestinationBackupFileName: string; const IgnoreMetadataErrors: Boolean); overload; static;
C++
static void __fastcall Replace(const System::UnicodeString SourceFileName, const System::UnicodeString DestinationFileName, const System::UnicodeString DestinationBackupFileName)/* overload */;
static void __fastcall Replace(System::UnicodeString SourceFileName, System::UnicodeString DestinationFileName, System::UnicodeString DestinationBackupFileName, const bool IgnoreMetadataErrors)/* overload */;
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
procedure function |
public | System.IOUtils.pas System.IOUtils.hpp |
System.IOUtils | TFile |
Description
Remplace le contenu d'un fichier par le contenu d'un autre fichier.
Utilisez Replace pour remplacer le contenu d'un fichier par le contenu d'un autre fichier. Replace effectue aussi une copie de sauvegarde du fichier remplacé. La première forme de Replace n'échoue pas si les métadonnées de fichier ne peuvent pas être fusionnées. La deuxième forme de Replace vous permet de spécifier si elle doit échouer en présence de conflits de métadonnées. Sur les systèmes d'exploitation Windows, les métadonnées de fichier incluent les listes de contrôle d'accès (ACLs, Access Control Lists), ainsi que d'autres informations dépendantes des fichiers.
Le tableau suivant liste les paramètres attendus par cette méthode.
Nom | Signification |
---|---|
SourceFileName |
Le chemin au fichier à partir duquel le contenu est copié. |
DestinationFileName |
Le chemin au fichier dont le contenu est remplacé. |
DestinationBackupFileName |
Le chemin au fichier de sauvegarde créé avant le début de l'opération de remplacement. |
IgnoreMetadataErrors |
Spécifie si les erreurs de métadonnées sont ignorées. |
Remarque : Replace déclenche une exception si le fichier source ou destination n'existe pas, si les chemins ne sont pas valides, ou si l'utilisateur n'a pas assez de privilèges pour effectuer l'opération de remplacement. Si le paramètre IgnoreMetadataErrors est défini sur False, une exception est déclenchée si la fusion des métadonnées échoue.
Remarque : Replace peut être utilisée seulement sur les fichiers résidant sur des partitions NTFS (plate-forme Windows).