CopyFolder (Método)

Visual Basic VBLR

CopyFolder (Método)

           

Descripción

Copia recursivamente una carpeta desde una ubicación a otra.

Sintaxis

objeto.CopyFolder origen, destino[, sobrescribir]

La sintaxis del método CopyFolder consta de las siguientes partes:

Parte Descripción
objeto Requerido. Siempre el nombre de un objeto FileSystemObject.
origen Requerido. Especificación de la carpeta de cadenas de caracteres, que puede incluir caracteres comodín, para una o más carpetas que se copian.
destino Requerido. El destino de la cadena de caracteres donde se van a copiar la carpeta o subcarpetas desde el origen. No se permiten los caracteres comodín.
sobrescribir Opcional. Un valor Boolean que indica si las carpetas existentes se van a sobrescribir. Si es True, los archivos se sobrescriben; si es False, no se sobrescriben. El valor predeterminado es True.

Comentarios

Los caracteres comodín sólo se pueden utilizar en el último componente de la ruta del argumento origen. Por ejemplo, puede utilizar:

FileSystemObject.CopyFolder "c:\Mis documentos\cartas\*", "c:\carpetatemp\"

Pero no puede utilizar:

FileSystemObject.CopyFolder "c:\Mis documentos\*\*", "c:\carpetatemp\"

Si el origen contiene caracteres comodín o el destino finaliza con un separador de ruta (\), se supone que destino es una carpeta existente en la que copiar las carpetas y subcarpetas coincidentes. Si no, se supone que el destino es el nombre de una carpeta que se va a crear. En cualquier caso, pueden ocurrir cuatro cosas cuando se copia una carpeta individual.

  • Si no existe el destino, se copian la carpeta origen y todo su contenido. Este es el caso normal.

  • Si el destino es un archivo existente, se produce un error.

  • Si el destino es un directorio, se hace un intento de copiar la carpeta y todo su contenido. Si existe ya en el destino un archivo contenido en origen, se produce un error si sobrescribir es False. Si no, se intentará copiar el archivo sobre el archivo existente.

  • Si el destino es un directorio de sólo lectura, se produce un error si se hace un intento de copiar un archivo de sólo lectura existente en ese directorio y sobrescribir es False.

También se produce un error si un origen que utiliza caracteres comodín no coincide con ninguna carpeta.

El método CopyFolder se detiene en el primer error que encuentra. No se hace ningún intento de volver atrás o deshacer cualquier cambio realizado antes de que se produzca un error.