System.IOUtils.TFile.Copy

• Übergeordnet: TFile

Delphi

class procedure Copy(const SourceFileName, DestFileName: string);  overload; inline; static;
class procedure Copy(const SourceFileName, DestFileName: string;  const Overwrite: Boolean); overload; static;

C++

static void __fastcall Copy(const System::UnicodeString SourceFileName, const System::UnicodeString DestFileName)/* overload */;
static void __fastcall Copy(const System::UnicodeString SourceFileName, const System::UnicodeString DestFileName, const bool Overwrite)/* overload */;

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
procedure function	public	System.IOUtils.pas System.IOUtils.hpp	System.IOUtils	TFile

Beschreibung

Kopiert eine Datei in den angegebenen Pfad.

Mit Copy können Sie eine Kopie einer Datei erstellen. Die erste Variante von Copy übernimmt als Parameter nur einen Quell- und einen Zielpfad. Wenn der Zielpfad auf eine bereits vorhandene Datei zeigt, löst Copy eine Exception aus. Die zweite Variante von Copy übernimmt den optionalen Parameter Overwrite. Hat dieser den Wert true, wird der Kopiervorgang auch dann durchgeführt, wenn die Zieldatei bereits vorhanden ist. Die folgende Tabelle enthält die von dieser Methode erwarteten Parameter.

Name	Bedeutung
SourceFileName	Der Pfad zur Datei, die kopiert werden soll.
DestFileName	Der Zielpfad, in den die Datei kopiert werden soll.
Overwrite	Gibt an, ob der Kopiervorgang auch dann durchgeführt werden soll, wenn sich bereits eine andere Datei in dem mit DestFileName angegebenen Pfad befindet.

Hinweis:   Copy löst eine Exception aus, wenn die Quelldatei nicht vorhanden ist, die Pfade ungültig sind oder der Benutzer nicht über ausreichende Rechte zur Durchführung des Kopiervorgangs verfügt.

Siehe auch

• OpenRead

• OpenText

• OpenWrite

Codebeispiele

• FileOperations (Delphi)
• FileOperations (C++)