Copy (Tarea)

Copia los archivos en el sistema de archivos a una nueva ubicación.

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 de salida 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á a la primera ubicación especificada en DestinationFiles y así en adelante.
DestinationFolder	Parámetro ITaskItem opcional. Especifica el directorio al que desea copiar los archivos.Éste 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 sólo 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 su proceso de compilación.
RetryDelayMilliseconds	Parámetro Int32 opcional. Especifica el retardo 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, 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 el mismo valor de última modificación. Nota Si se establece este parámetro como true, no deberá utilizar el análisis de dependencias en el destino continente, ya que sólo se ejecuta la tarea si el valor de última modificación de los archivos de código fuente es más reciente que el valor de última modificación 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 DestinationFolder o el parámetro DestinationFiles, pero no ambos.Si se especifican los dos, en la tarea se 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 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>

Vea también

Conceptos

Tareas de MSBuild

Otros recursos

Referencia de tareas de MSBuild