COPY DOCUMENT
COPY DOCUMENT ( nomFonte ; nomDest {; newName} {; *} )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| nomFonte | Text | → | Nome do documento a copiar |
| nomDest | Text | → | Nome do documento copiado |
| newName | Text | → | New name of copied file or folder |
| * | Operador | → | Substituir documento existente, se houver |
Descrição
O comando COPY DOCUMENT copia o documento especificado por nomFonte na localização especificada por nomDest.
Este caso, o parâmetro nomFonte deve conter um caminho de arquivo completo, expressa em relação à raiz do volume.
O parâmetro nomDest pode conter vários tipos de locais:
- um caminho de arquivo completo expressa com relação à raiz do volume: o arquivo é copiado para este local
- um nome de arquivo ou caminho do arquivo relativo: o arquivo é copiado para a pasta de banco de dados (as subpastas já deve existir)
- um caminho de pasta completo ou um caminho relativo para a pasta base de dados (nomDest deve terminar com o separador de pasta para a plataforma): o arquivo é copiado para a pasta designada. Essas pastas já devem existir no disco, não são criadas.
Será gerado um erro se já houver um documento chamado nomDest a menos que tenha especificado o parâmetro opcional * que lhe indica a COPY DOCUMENT que apague e substitua o documento existente pelo documento de destino. - Cópia de pasta s
Para indicar que você está designando uma pasta, as sequências passadas em nomFonte e nomDest deve terminar com um separador de pasta para a plataforma. Por exemplo, no Windows "C:\\Element\\" designa uma pasta e "C:\\Element" designa um arquivo.
Para copiar uma pasta, passe o seu caminho completo em nomFonte. Esta pasta já deve existir no disco. Quando uma pasta é definida no parâmetro nomFonte, a pasta deve também ser designada no parâmetro nomDest. Deve passar uma rota de acesso completa de pasta (cada elemento já deve existir no disco).
Se yá existir uma pasta com o mesmo nome da pasta designada pelo parâmetro nomFonte na localização definida pelo parâmetro nomDest e não está vazia, 4D verifica seu conteúdo antes de copiar os elementos. Um erro é gerado quando já existe um arquivo com o mesmo nome, a menos que tenha passado o parâmetro opcional *, que indica ao comando excluir e substituir o arquivo no lugar de destino.
Note que você pode passar um arquivo no parâmetro nomFonte e uma pasta no parâmetro nomDest, a fim de copiar um arquivo em uma pasta.
O parâmetro opcional novoNome, se passar, permite renomear o documento copiado a sua localização de destino (arquivo ou pasta). Quando se passa no contexto de uma cópia de arquivo, este parâmetro substitui o nome (se existir) passado no parâmetro nomDest.
Exemplo 1
O exemplo abaixo duplica um documento em sua própria pasta:
COPY DOCUMENT("C:\\PASTA\\DocNome";"C:\\PASTA\\DocNome2")
Exemplo 2
O exemplo abaixo copia um documento na pasta do banco (sempre e quando C:\\PASTA não seja a pasta do banco):
COPY DOCUMENT("C:\\PASTA \\DocNome";"DocNome")
Exemplo 3
O exemplo abaixo copia um documento de um volume a outro:
COPY DOCUMENT("C:\\PASTA \\DocNome";"F:\\Arquivos\\DocNome.OLD")
Exemplo 4
O exemplo abaixo duplica um documento em sua própria pasta, substituindo uma cópia existente:
COPY DOCUMENT("C:\\PASTA \\DocNome";"C:\\PASTA \\DocNome2";*)
Exemplo 5
Cópia de um arquivo em uma pasta específica, mantendo o mesmo nome:
COPY DOCUMENT("C:\\Projects\\DocName";"C:\\Projects\\")
Exemplo 6
Cópia de um arquivo em uma pasta específica, mantendo o mesmo nome e substituir o documento existente:
COPY DOCUMENT("C:\\Projects\\DocName";"C:\\Projects\\"; *)
Exemplo 7
Copia de uma pasta para outra pasta (ambas as pastas já devem estar presentes no disco):
COPY DOCUMENT("C:\\Projects\\";"C\\Archives\\2011\\")
Exemplo 8
Os seguintes exemplos criam diferentes arquivos e pastas na pasta da base (exemplos em Windows). Em cada caso, a pasta "folder2" deve existir:
COPY DOCUMENT("folder1\\name1";"folder2\\")
//Cria o arquivo "folder2/name1"
COPY DOCUMENT("folder1\\name1";"folder2\\" ; "new")
//Cria o arquivo "folder2/new"
COPY DOCUMENT("folder1\\name1";"folder2\\name2")
//Cria o arquivo "folder2/name2"
COPY DOCUMENT("folder1\\name1";"folder2\\name2";"new")
//Cria o arquivo "folder2/new" (name2 se ignora)
COPY DOCUMENT("folder1\\" ; "folder2\\")
//Cria a pasta "folder2/folder1/"
COPY DOCUMENT("folder1\\" ; "folder2\\" ; "new")
//Cria a pasta "folder2/new/"
Ver também
Documentos de Sistema
MOVE DOCUMENT
Propriedades
| Número do comando | 541 |
| Thread-seguro | ✓ |
| Modificar variáveis | OK, error |