Kopírovat úkol

Zkopíruje soubory v systému souborů do nového umístění.

Parametry

Následující tabulka popisuje parametry Copy úkolu.

Parametr	Description
CopiedFiles	Volitelný ITaskItem[] výstupní parametr. Obsahuje položky, které byly úspěšně zkopírovány.
DestinationFiles	Volitelný ITaskItem[] výstupní parametr. Určuje seznam souborů zkopírovat zdrojové soubory.Tento seznam se očekává mapování 1: 1 v seznamu SourceFiles parametr.Je první soubor zadaný v SourceFiles budou zkopírovány na první místo v DestinationFiles, a tak dále.
DestinationFolder	Volitelný ITaskItem parametr. Určuje adresář, do kterého chcete zkopírovat soubory.Musí to být adresář není soubor.Pokud adresář neexistuje, bude vytvořen automaticky.
OverwriteReadOnlyFiles	Volitelný Boolean parametr. Přepsat soubory i v případě, že jsou označeny jako číst pouze soubory.
Retries	Volitelný Int32 parametr. Určuje, kolikrát pokus kopírovat, pokud selhaly všechny předchozí pokusy.Výchozí hodnota je nula. Poznámka: použití opakování můžete maskovat problému synchronizace procesu sestavení.
RetryDelayMilliseconds	Volitelný Int32 parametr. Určuje zpoždění mezi opakováními jakékoli nezbytné.Výchozí nastavení argumentu RetryDelayMillisecondsDefault je předaný konstruktoru CopyTask.
SkipUnchangedFiles	Volitelný Boolean parametr. Pokud true, přeskočí kopírování souborů, které jsou mezi zdrojovou a cílovou beze změny.Copy Úkol považuje za beze změny, pokud mají stejnou velikost a stejný čas poslední změny souborů. Poznámka Pokud nastavíte tento parametr na true, byste neměli používat analýza závislost na cílové obsahující protože pouze spuštění úlohy Pokud poslední změny časy zdrojové soubory, které jsou novější než poslední změny časů cílových souborů.
SourceFiles	Požadované ITaskItem[] parametr. Určuje soubory zkopírovat.
UseHardlinksIfPossible	Volitelný Boolean parametr. Pokud true, vytvoří pevné odkazy pro zkopírované soubory místo kopírování souborů.

Poznámky

Buď DestinationFolder nebo DestinationFiles parametr musí být zadaný, ne však obojí.Pokud jsou uvedeny obě úlohy nezdaří a zaznamenána chyba.

Vedle výše uvedených parametrů, zdědí tento úkol parametry z TaskExtension dědí třídu, která sama Task třídy.Seznam těchto další parametry a jejich popis naleznete v TaskExtension základní třída.

Příklad

Následující příklad zkopíruje položky MySourceFiles položka kolekce do složky 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>

Následující příklad ukazuje, jak kopírovat rekurzivní.Tento projekt zkopíruje všechny rekurzivně soubory z c:\MySourceTree do c:\MyDestinationTree, při zachování struktury adresářů.

<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>

Viz také

Koncepty

Nástroj MSBuild úkoly

Další zdroje

Úloha MSBuild odkaz