DownloadFile – úloha

  • Článek

Stáhne zadané soubory pomocí protokolu HTTP (Hyper-Text Transfer Protocol).

Poznámka

Úloha DownloadFile je k dispozici pouze v nástroji MSBuild 15.8 a vyšší.

Parametry

Následující tabulka popisuje parametry DownloadFile úlohy.

Parametr Popis
DestinationFileName Volitelný ITaskItem parametr

Název, který se má použít pro stažený soubor. Ve výchozím nastavení se název souboru odvozuje od vzdáleného SourceUrl serveru nebo ze vzdáleného serveru.
DestinationFolder Požadovaný parametr ITaskItem.

Určuje cílovou složku, do které se má soubor stáhnout. Pokud složka neexistuje, vytvoří se.
DownloadedFile Volitelný ITaskItem výstupní parametr.

Určuje stažený soubor.
Retries Volitelný Int32 parametr.

Určuje, kolikrát se má pokus o stažení, pokud všechny předchozí pokusy selhaly. Výchozím nastavením je nula.
RetryDelayMilliseconds Volitelný Int32 parametr.

Určuje zpoždění v milisekundách mezi potřebnými opakováními. Výchozí hodnota je 5000.
SkipUnchangedFiles Volitelný Boolean parametr.

Pokud truese stahování souborů, které se nezměnily, přeskočí. Výchozí hodnota trueje . Úloha DownloadFile považuje soubory za nezměněné, pokud mají stejnou velikost a stejný čas poslední změny podle vzdáleného serveru.

Poznámka: Ne všechny servery HTTP označují datum poslední změny souborů způsobí, že se soubor znovu stáhne.
SourceUrl Požadovaný parametr String.

Určuje adresu URL, která se má stáhnout.

Poznámky

Kromě výše uvedených parametrů tato úloha dědí parametry z TaskExtension třídy, která sama dědí z Task třídy. Seznam těchto dalších parametrů a jejich popisů naleznete v tématu TaskExtension základní třída.

Příklad

Následující příklad stáhne soubor a zahrne ho do Content položek před sestavením projektu.

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">

    <PropertyGroup>
      <MyUrl>https://raw.githubusercontent.com/Microsoft/msbuild/master/LICENSE</MyUrl>
    </PropertyGroup>

    <Target Name="DownloadContentFiles" BeforeTargets="Build">
        <DownloadFile
            SourceUrl="$(MyUrl)"
            DestinationFolder="$(MSBuildProjectDirectory)">
        <Output TaskParameter="DownloadedFile" ItemName="Content" />
      </DownloadFile>
    </Target>

</Project>

Viz také