Copy (Tarea)
Copia los archivos en una nueva ubicación del sistema de archivos.
Parámetros
En la siguiente tabla se describen los parámetros de la tarea Copy.
Parámetro |
Descripción |
---|---|
CopiedFiles |
Parámetro de salida ITaskItem[] opcional. Contiene los elementos que se copiaron correctamente. |
DestinationFiles |
Parámetro ITaskItem[] opcional. Especifica la lista de archivos en la que se copiarán los archivos de código fuente. Se espera que esta lista sea una asignación unívoca con la lista especificada en el parámetro SourceFiles. Es decir, el primer archivo especificado en SourceFiles se copiará en la primera ubicación especificada en DestinationFiles, etc. |
DestinationFolder |
Parámetro ITaskItem opcional. Especifica el directorio en el que desea copiar los archivos. Este debe ser un directorio, no un archivo. Si el directorio no existe, se crea automáticamente. |
OverwriteReadOnlyFiles |
Parámetro Boolean opcional. Sobrescribe los archivos aunque estén marcados como archivos de solo lectura |
Retries |
Parámetro Int32 opcional. Especifica cuántas veces se intentará copiar, si se produjera un error en todos los intentos anteriores. Se establece en cero de forma predeterminada. Nota: El uso de reintentos puede enmascarar un problema de sincronización en el proceso de compilación. |
RetryDelayMilliseconds |
Parámetro Int32 opcional. Especifica el retraso entre los reintentos necesarios. Adopta como valor predeterminado el argumento RetryDelayMillisecondsDefault, que se pasa al constructor CopyTask. |
SkipUnchangedFiles |
Parámetro Boolean opcional. Si es true, se omite la copia de los archivos sin modificar entre el origen y destino. La tarea Copy considera que los archivos están sin modificar si tienen el mismo tamaño y la misma hora de última modificación. Nota Si se establece este parámetro como true, no deberá usar el análisis de dependencias en el destino continente, ya que solo se ejecuta la tarea si las horas de última modificación de los archivos de origen son más recientes que las de los archivos de destino. |
SourceFiles |
Parámetro ITaskItem[] requerido. Especifica los archivos que se van a copiar. |
UseHardlinksIfPossible |
Parámetro Boolean opcional. Si es true, crea vínculos físicos para los archivos copiados en lugar de copiar los archivos. |
Comentarios
Se debe especificar el parámetro DestinationFolder o DestinationFiles, pero no ambos. Si se especifican los dos, la tarea produce un error y se registra un error.
Además de los parámetros mencionados anteriormente, esta tarea hereda los parámetros de la clase TaskExtension, que a su vez hereda de la clase Task. Para obtener una lista de estos parámetros adicionales y sus descripciones, vea TaskExtension (Clase base).
Ejemplo
En el ejemplo siguiente se copian los elementos de la colección de elementos MySourceFiles en la carpeta c:\MyProject\Destination.
<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
<ItemGroup>
<MySourceFiles Include="a.cs;b.cs;c.cs"/>
</ItemGroup>
<Target Name="CopyFiles">
<Copy
SourceFiles="@(MySourceFiles)"
DestinationFolder="c:\MyProject\Destination"
/>
</Target>
</Project>
En el ejemplo siguiente se muestra cómo hacer una copia recursiva. Este proyecto copia de forma recursiva todos los archivos de c:\MySourceTree a c:\MyDestinationTree, manteniendo la estructura de directorios.
<Project xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
<ItemGroup>
<MySourceFiles Include="c:\MySourceTree\**\*.*"/>
</ItemGroup>
<Target Name="CopyFiles">
<Copy
SourceFiles="@(MySourceFiles)"
DestinationFiles="@(MySourceFiles->'c:\MyDestinationTree\%(RecursiveDir)%(Filename)%(Extension)')"
/>
</Target>
</Project>