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 */;
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
procedure function |
public | System.IOUtils.pas System.IOUtils.hpp |
System.IOUtils | TFile |
Beschreibung
Ersetzt den Inhalt einer Datei durch den Inhalt einer anderen Datei.
Mit Replace können Sie den Inhalt einer Datei durch den Inhalt einer anderen Datei ersetzen. Replace erstellt eine Sicherungskopie der ersetzten Datei. Die erste Variante von Replace schlägt nicht fehl, wenn die Metadaten der Datei nicht zusammengeführt werden können. Mit der zweiten Variante von Replace können Sie festlegen, ob die Methode fehlschlagen soll, wenn Konflikte bei Metadaten auftreten. In Windows-Betriebssystemen zählen ACLs (Access Control Lists) und weitere dateibezogene Informationen zu den Metadaten einer Datei.
Die folgende Tabelle enthält die von dieser Methode erwarteten Parameter.
| Name | Bedeutung |
|---|---|
|
SourceFileName |
Der Pfad der Datei, deren Inhalt kopiert werden soll. |
|
DestinationFileName |
Der Pfad der Datei, deren Inhalt ersetzt werden soll. |
|
DestinationBackupFileName |
Der Pfad der Sicherungsdatei, die vor der Durchführung der Ersetzungsoperation erstellt wird. |
|
IgnoreMetadataErrors |
Legt fest, ob Metadatenfehler ignoriert werden. |
Anmerkung: Replace löst eine Exception aus, wenn die Quell- oder Zieldatei nicht vorhanden ist, die Pfade ungültig sind oder der Benutzer nicht über ausreichende Rechte zur Durchführung des Ersetzungsvorgangs verfügt. Ist IgnoreMetadataErrors auf false gesetzt, wird eine Exception ausgelöst, wenn das Zusammenführen von Metadaten fehlschlägt.
Anmerkung: Replace kann nur mit Dateien verwendet werden, die sich auf NTFS-Partitionen (Windows-Plattform) befinden.