fichier.copyTo( )

4D v19.8

fichier.copyTo( )


fichier.copyTo ( dossierDestination {; nouveauNom}{; écraser} ) -> Résultat

Paramètre	Type	Description
dossierDestination	Objet	Dossier de destination
nouveauNom	Texte	Nom de la copie
écraser	Entier long	fk écraser pour écraser les éléments existants
Résultat	Objet	Fichier copié

Description

La méthode file.copyTo( ) copie l'objet File (fichier source) vers le dossierDestination spécifié.

Le dossierDestination doit exister sur disque, sinon une erreur est générée.

Par défaut, le fichier est copié avec le nom du fichier original. Si vous souhaitez renommer la copie, passez le nouveau nom dans le paramètre nouveauNom. Le nouveau nom doit être conforme aux règles de nommage (ex : il ne doit pas contenir de caractères tels que ":", "/", etc.), sinon une erreur est retournée.

S'il existe déjà un fichier portant le même nom dans dossierDestination, par défaut 4D génère une erreur. Vous pouvez passer la constante fk overwrite dans le paramètre écraser pour ignorer et écraser le fichier existant :

Constante	Valeur	Comment
fk overwrite	4	Ecrase les élements existants, le cas échéant

Objet retourné

La méthode retourne l'objet File copié.

Exemple

Vous souhaitez copier un fichier image, à partir du dossier Documents de l'utilisateur vers le dossier de la base :

 C_OBJECT($source;$copy)

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

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

Voir aussi

COPY DOCUMENT