4D v18

file.copyTo

Home

 
4D v18
file.copyTo

file.copyTo  


 

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.

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

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: File und Folder

Dieser Befehl kann in preemptive Prozessen laufen

 
SEITENINHALT 
 
GESCHICHTE 

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v18)