file.copyTo( )

4D v19.8

file.copyTo( )


file.copyTo ( pastaDestino {; novoNome}{; sobrescrever} ) -> Resultado

Parâmetro	Tipo	Descrição
pastaDestino	Objeto	Pasta destino
novoNome	Texto	Nome da cópia
sobrescrever	Inteiro longo	fk overwrite para substituir os elementos existentes
Resultado	Objeto	Arquivo copiado

Descrição

O método file.copyTo( ) copia o objeto File (arquivo fonte) na pastaDestino especificada.

A pastaDestino deve existir no disco, do contrário se gera um erro.

De forma predeterminada, o arquivo se copia com o nome de arquivo original. Se quiser mudar o nome da cópia, passe o novo nome no parâmetro novoNome. O novo nome deve cumprir com as regras de denominação (por exemplo, não deve conter caracteres como ":", "/", etc.), do contrário se devolve um erro.

Se existir um arquivo com o mesmo nome na pastaDestino, 4D gera um erro de forma predeterminada. Pode passar a constante fk overwrite no parâmetro sobreescribir para ignorar e sobrescrever o arquivo existente:

Constante	Valor	Comentário
fk overwrite	4	Sobrescrever os elementos existentes, se houver

Objeto devolvido

O método devolvido o objeto File copiado.

Exemplo

Se quiser copiar um arquivo imagem da pasta Documents de usuário à pasta do banco de dados:

 C_OBJECT($source;$copy)

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

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

Ver também

COPY DOCUMENT