DownloadFile-taak

Downloadt de opgegeven bestanden met behulp van het Hyper-Text Transfer Protocol (HTTP).

Opmerking

De DownloadFile-taak is alleen beschikbaar in MSBuild 15.8 en hoger.

Parameterwaarden

In de volgende tabel worden de parameters van de DownloadFile taak beschreven.

Kenmerk	Beschrijving
DestinationFileName	Optionele ITaskItem parameter De naam die moet worden gebruikt voor het gedownloade bestand. Standaard wordt de bestandsnaam afgeleid van de SourceUrl of de externe server.
DestinationFolder	Vereiste ITaskItem parameter. Hiermee geeft u de doelmap waarnaar het bestand moet worden gedownload. De map wordt gemaakt als deze niet bestaat.
DownloadedFile	Optionele ITaskItem uitvoerparameter. Hiermee geeft u het bestand dat is gedownload.
Retries	Optionele Int32 parameter. Hiermee geeft u op hoe vaak moet worden gedownload, als alle vorige pogingen zijn mislukt. De standaardwaarde is nul.
RetryDelayMilliseconds	Optionele Int32 parameter. Hiermee geeft u de vertraging in milliseconden tussen eventuele noodzakelijke nieuwe pogingen. De standaardwaarde is 5000.
SkipUnchangedFiles	Optionele Boolean parameter. Als true, slaat het downloaden van bestanden die ongewijzigd. Wordt standaard ingesteld op true. De DownloadFile taak beschouwt bestanden als ongewijzigd als ze dezelfde grootte en dezelfde laatste wijzigingstijd hebben op basis van de externe server. Opmerking: Niet alle HTTP-servers geven aan dat de laatst gewijzigde datum van bestanden het bestand opnieuw zal worden gedownload.
SourceUrl	Vereiste String parameter. Hiermee geeft u de URL die moet worden gedownload.

Opmerkingen

Naast de bovenstaande parameters neemt deze taak parameters over van de TaskExtension klasse, die zelf van de Task klasse overgaat. Zie de basisklasse TaskExtension voor een lijst met deze aanvullende parameters en de bijbehorende beschrijvingen.

Voorbeeld

In het volgende voorbeeld wordt een bestand gedownload en opgenomen in de Content items voordat u het project bouwt.

<Project>

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

Zie ook

• taken
• Taakreferentie