Comando
MoveFile()
Move um arquivo para outro caminho (equivale a recortar e colar). Suporta wildcard para mover múltiplos arquivos. Cria o diretório de destino automaticamente se não existir.
MoveFile(origem, destino [, sobrescrever])
Parâmetros
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
origem | Sim | Caminho completo do arquivo a mover. Aceita wildcard * para mover múltiplos arquivos. |
destino | Sim | Caminho de destino. Pode ser: • Caminho completo do arquivo: @'C:\processado\dados.xlsx'• Pasta de destino (terminar com \): @'C:\processado\' — o nome do arquivo original é preservado. |
sobrescrever | Não | True: sobrescreve o arquivo de destino se já existir. False (padrão): não sobrescreve. |
Exemplos
// Mover arquivo para outra pasta:
MoveFile(@'C:\entrada\dados.csv', @'C:\processado\')
// Mover e renomear:
MoveFile(@'C:\temp\saida.pdf', @'C:\final\relatorio_2024.pdf')
// Mover com sobrescrita:
MoveFile(@'C:\temp\relatorio.pdf', @'C:\final\relatorio.pdf', True)
// Mover múltiplos arquivos:
MoveFile(@'C:\entrada\*.csv', @'C:\processado\')
Observações
Se a origem não existir, o arquivo é ignorado silenciosamente. Com wildcard, move todos os arquivos correspondentes para a pasta de destino. O diretório de destino é criado automaticamente se não existir.