file.copyTo( )

4D v19.8

file.copyTo( )


file.copyTo ( carpetaDestino {; nuevoNombre}{; sobreescribir} ) -> Resultado

Parámetro	Tipo	Descripción
carpetaDestino	Objeto	Carpeta de destino
nuevoNombre	Texto	Nombre para la copia
sobreescribir	Entero largo	fk overwrite para reemplazar elementos existentes
Resultado	Objeto	Archivo copiado

Descripción

El método file.copyTo( ) copia el objeto File (archivo fuente) en la carpetaDestino especificada.

La carpetaDestino debe existir en el disco, de lo contrario se genera un error.

De forma predeterminada, el archivo se copia con el nombre del archivo original. Si desea cambiar el nombre de la copia, pase el nuevo nombre en el parámetro nuevoNombre. El nuevo nombre debe cumplir con las reglas de denominación (por ejemplo, no debe contener caracteres como ":", "/", etc.), de lo contrario se devuelve un error.

Si ya existe un archivo con el mismo nombre en la carpetaDestino, 4D genera un error de forma predeterminada. Puede pasar la constante fk overwrite en el parámetro sobreescribir para ignorar y sobrescribir el archivo existente:

Constante	Valor	Comentario
fk overwrite	4	Sobrescribir los elementos existentes, si los hay

Objeto devuelto

El método devuelve el objeto File copiado.

Ejemplo

Desea copiar un archivo imagen de la carpeta Documents del usuario a la carpeta de la base:

 C_OBJECT($source;$copy)

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

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

Ver también

COPY DOCUMENT