4D v20.1
COPY DOCUMENT
- Manual de lenguaje 4D
-
- Documentos del sistema
-
- Documentos del sistema
- Append document
- CLOSE DOCUMENT
- Convert path POSIX to system
- Convert path system to POSIX
- COPY DOCUMENT
- CREATE ALIAS
- Create document
- CREATE FOLDER
- DELETE DOCUMENT
- DELETE FOLDER
- DOCUMENT LIST
- Document to text
- FOLDER LIST
- GET DOCUMENT ICON
- Get document position
- GET DOCUMENT PROPERTIES
- Get document size
- Get localized document path
- MOVE DOCUMENT
- Object to path
- Open document
- Path to object
- RESOLVE ALIAS
- Select document
- Select folder
- SET DOCUMENT POSITION
- SET DOCUMENT PROPERTIES
- SET DOCUMENT SIZE
- SHOW ON DISK
- Test path name
- TEXT TO DOCUMENT
- VOLUME ATTRIBUTES
- VOLUME LIST
COPY DOCUMENT
| COPY DOCUMENT ( nomFuente ; nomDest {; nuevNombre} {; *} ) | ||||||||
| Parámetro | Tipo | Descripción | ||||||
| nomFuente | Cadena |
|
Nombre del documento a copiar | |||||
| nomDest | Cadena |
|
Nombre del documento copiado | |||||
| nuevNombre | Cadena |
|
Nuevo nombre del archivo o carpeta copiado | |||||
| * | Operador |
|
Reemplazar documento existente si lo hay | |||||
El comando COPY DOCUMENT copia el documento especificado por nomFuente en la ubicación especificada por nomDest.
- Copia de archivo
En este caso, el parámetro nomFuente debe contener una ruta de acceso completa del archivo, expresada con respecto a la raíz del volumen.
El parámetro nomDest puede contener varios tipos de lugares:- una ruta de acceso completa del archivo expresada con respecto a la raíz del volumen: el archivo se copia en esta ubicación
- un nombre de archivo o una ruta de acceso del archivo relativa: el archivo se copia en la carpeta de la base (las subcarpetas ya deben existir)
- una ruta de acceso completa de la carpeta o una ruta relativa a la carpeta de la base (nomDest debe terminar con el separador de carpeta de la plataforma): el archivo se copia en la carpeta designada. Estas carpetas ya deben existir en el disco, no se crean.
- Copia de carpeta
Para indicar que se designa una carpeta, las cadenas pasadas en nomFuente y nomDest deben terminar con un separador de carpetas de la plataforma. Por ejemplo, en Windows "C: \\Element\\" designa una carpeta y "C:\\Element" designa un archivo.
Para copiar una carpeta, pase su ruta de acceso completa en nomFuente. Esta carpeta debe existir en el disco. Cuando una carpeta se define en el parámetro nomFuente, una carpeta también deberá designarse en el parámetro nomDest. Debe pasar una ruta de acceso completa de carpeta (cada elemento ya debe existir en el disco).
Si ya existe una carpeta con el mismo nombre de la carpeta designada por el parámetro nomFuente en la ubicación definida por el parámetro nomDest y no está vacía, 4D verifica su contenido antes de copiar los elementos. Un error se genera cuando ya existe un archivo con el mismo nombre, a menos que haya pasado el parámetro opcional *, que indica al comando borrar y remplazar el archivo en la ubicación de destino.
El parámetro opcional nuevoNombre, si se pasa, permite renombrar el documento copiado a su ubicación de destino (archivo o carpeta). Cuando se pasa en el contexto de una copia de archivo, este parámetro remplaza el nombre (si lo hay) pasado en el parámetro nomDest.
El siguiente ejemplo duplica un documento en su propia carpeta:
COPY DOCUMENT("C:\\CARPETA\\DocNombre";"C:\\CARPETA\\DocNombre2")El siguiente ejemplo copia un documento en la carpeta de la base (siempre y cuando C:\\CARPETA no sea la carpeta de la base):
COPY DOCUMENT("C:\\CARPETA \\DocNombre";"DocNombre")El siguiente ejemplo copia un documento de un volumen a otro:
COPY DOCUMENT("C:\\CARPETA \\DocNombre";"F:\\Archivos\\DocNombre.OLD")El siguiente ejemplo duplica un documento en su propia carpeta, sobrescribiendo una copia existente:
COPY DOCUMENT("C:\\CARPETA \\DocNombre";"C:\\CARPETA \\DocNombre2";*)Copia de un archivo en una carpeta específica conservando el mismo nombre:
COPY DOCUMENT("C:\\Projects\\DocName";"C:\\Projects\\")Copiar un archivo en una carpeta específica conservando el mismo nombrey remplazando el documento existente:
COPY DOCUMENT("C:\\Projects\\DocName";"C:\\Projects\\"; *)Copia de una carpeta en otra carpeta (ambas carpetas deben existir en el disco):
COPY DOCUMENT("C:\\Projects\\";"C\\Archives\\2011\\")Los siguientes ejemplos crean diferentes archivos y carpetas en la carpeta de la base (ejemplos bajo Windows). En cada caso, la carpeta "folder2" debe existir:
COPY DOCUMENT("folder1\\name1";"folder2\\")
//crea el archivo "folder2/name1"
COPY DOCUMENT("folder1\\name1";"folder2\\" ; "new")
//crea el archivo "folder2/new"
COPY DOCUMENT("folder1\\name1";"folder2\\name2")
//crea el archivo "folder2/name2"
COPY DOCUMENT("folder1\\name1";"folder2\\name2";"new")
//crea el archivo "folder2/new" (name2 se ignora)
COPY DOCUMENT("folder1\\" ; "folder2\\")
//crea la carpeta "folder2/folder1/"
COPY DOCUMENT("folder1\\" ; "folder2\\" ; "new")
//crea la carpeta "folder2/new/"
Producto: 4D
Tema: Documentos del sistema
Número
541
Creado por: 4D v6
Modificado: 4D v13
Modificado: 4D v14
Manual de lenguaje 4D ( 4D v20)
Manual de lenguaje 4D ( 4D v20.1)
