4D v19

file.copyTo( )

Página Inicial

 
4D v19
file.copyTo( )

file.copyTo( )  


 

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

 
PROPRIEDADES 

Produto: 4D
Tema: Arquivo e Pasta

This command can be run in preemptive processes

 
CONTEÚDO DA PÁGINA 
 
HISTÓRIA 

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v19)
Manual de linguagem 4D ( 4D v19.1)