file.copyTo

Home

4D v19.8

file.copyTo


file.copyTo ( destinationFolder {; newName}{; overwrite} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
destinationFolder	Objekt	Zielordner
newName	Text	Name der Kopie
overwrite	Lange Ganzzahl	fk overwrite zum Ersetzen vorhandener Elemente
Funktionsergebnis	Objekt	Kopierte Datei

Beschreibung

Die Methode file.copyTo kopiert das Objekt File (Quell-File) in den angegebenen destinationFolder.

Der destinationFolder muss auf der Festplatte existieren, sonst wird ein Fehler generiert.

File wird standardmäßig mit dem Namen des Original-File kopiert. Wollen Sie die Kopie umbenennen, übergeben Sie im Parameter newName den neuen Namen. Er muss die Namensregeln einhalten, z.B. darf er nicht die Zeichen ":", "/", etc. enthalten, sonst wird ein Fehler zurückgegeben.

Existiert in destinationFolder bereits ein File mit demselben Namen, generiert 4D standardmäßig einen Fehler. Optional können Sie im Parameter overwrite die Konstante fk overwrite übergeben, um die vorhandene File zu ignorieren und zu überschreiben:

Konstante	Wert	Kommentar
fk overwrite	4	Vorhandene Elemente überschreiben, wenn vorhanden

Zurückgegebenes Objekt

Die Methode gibt das kopierte Objekt File zurück.

Beispiel

Sie wollen eine Bilddatei vom Ordner Document des Benutzers in den Ordner der Datenbank kopieren:

 C_OBJECT($source;$copy)

 $source:=Folder(fk documents folder).file("Pictures/photo.png")

 $copy:=$source.copyTo(Folder("/PACKAGE");fk overwrite)

Siehe auch

COPY DOCUMENT