dossier.copyTo( )

4D v19.8

dossier.copyTo( )


dossier.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	Dossier copié

Description

La méthode dossier.copyTo( ) copie l'objet Dossier (dossier source) vers le dossierDestination spécifié.

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

Par défaut, le dossier est copié avec le nom du dossier 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 dossier portant le même nom dans dossierDestination et s'il n'est pas vide, par défaut 4D vérifie son contenu avant de copier les éléments et génère une erreur si un fichier portant le même nom existe. Vous pouvez passer la constante fk écraser dans le paramètre écraser pour ignorer et écraser le dossier existant :

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

Objet retourné

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

Exemple

Vous souhaitez copier un dossier Images, à partir du dossier Document de l'utilisateur vers le dossier de la base :

 C_OBJET($userImages;$copiedImages)

 $userImages:=Dossier(fk dossier documents+"/Images/")

 $copiedImages:=$userImages.copyTo(Folder(fk dossier base de données);fkécraser)

Voir aussi

COPIER DOCUMENT
dossier.moveTo( )