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 */;
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
procedure function |
public | System.IOUtils.pas System.IOUtils.hpp |
System.IOUtils | TFile |
説明
ファイルの内容を別のファイルの内容に置き換えます。
ファイルの内容を別のファイルの内容に置き換えるには、Replace を使用します。Replace は、置き換えられるファイルのバックアップも行います。1 番目の形式の Replace は、ファイルのメタデータをマージできない場合は失敗します。2 番目の形式の Replace では、メタデータが競合する場合に失敗させるかどうかを指定できます。Windows オペレーティング システムでは、ファイルのメタデータに ACL(アクセス制御リスト)とその他のファイル依存の情報が含まれます。
このメソッドに必要なパラメータの一覧を以下の表に示します。
名前 | 意味 |
---|---|
SourceFileName |
内容のコピー元となるファイルのパス。 |
DestinationFileName |
内容が置換されるファイルのパス。 |
DestinationBackupFileName |
置換操作を実行する前に作成されるバックアップ ファイルのパス。 |
IgnoreMetadataErrors |
メタデータのエラーを無視するかどうかを指定します。 |
メモ: コピー元または置換先のファイルが存在しない場合、パスが無効な場合、または置換操作を行う権限をユーザーが持っていない場合には、Replace は例外を発生させます。IgnoreMetadataErrors が False に設定されている場合は、メタデータのマージに失敗すると例外が発生します。
メモ: Replace は、NTFS パーティション(Windows プラットフォーム)上に位置するファイル上でのみ使用できます。