folder.copyTo

Home

4D v19.8

folder.copyTo


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

Parameter	Typ	Beschreibung
destinationFolder	Objekt	Zielordner
newName	Text	Name der Kopie
overwrite	Lange Ganzzahl	fk overwrite zum Ersetzen der vorhandenen Elemente
Funktionsergebnis	Objekt	Kopierter Ordner

Beschreibung

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

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

Folder wird standardmäßig mit dem Namen des Original-Folder kopiert. Wollen Sie die Kopie umbenennen, übergeben Sie im optionalen 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 bereits ein Folder mit demselben Namen in destinationFolder und ist er nicht leer, prüft 4D standardmäßig seinen Inhalt vor dem Kopieren und generiert einen Fehler, wenn bereits ein File mit demselben Namen existiert. Optional können Sie im Parameter overwrite die Konstante fk overwrite übergeben, um den vorhandenen Folder 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 Folder zurück.

Beispiel

Sie wollen einen Ordner Pictures aus dem Ordner Documents des Benutzers in den Ordner der Datenbank kopieren:

 C_OBJECT($userImages;$copiedImages)

 $userImages:=Folder(fk documents folder+"/Pictures/")

 $copiedImages:=$userImages.copyTo(Folder(fk database folder);fk overwrite)

Siehe auch

COPY DOCUMENT
folder.moveTo