Freigeben über

DownloadFile-Aufgabe

  • Artikel

Diese Aufgabe lädt die angegebenen Dateien mithilfe des Hypertext Transfer-Protokolls (HTTP) herunter.

Hinweis

Die DownloadFile-Aufgabe ist nur in MSBuild 15.8 und höher verfügbar.

Parameter

In der folgenden Tabelle werden die Parameter der DownloadFile -Aufgabe beschrieben.

Parameter Beschreibung
DestinationFileName Optionaler ITaskItem-Parameter

Der Name, der für die heruntergeladene Datei verwendet werden soll. Der Dateiname wird standardmäßig von SourceUrl oder vom Remoteserver abgeleitet.
DestinationFolder Erforderlicher ITaskItem-Parameter.

Gibt den Zielordner an, in den die Datei heruntergeladen werden soll. Der Ordner wird erstellt, falls er noch nicht vorhanden ist.
DownloadedFile Optionaler ITaskItem-Ausgabeparameter.

Gibt die Datei an, die heruntergeladen wird.
Retries Optionaler Int32-Parameter.

Gibt die Anzahl der vorgesehenen Downloadversuche an, wenn alle vorherigen Versuche fehlgeschlagen sind. Der Standardwert ist 0 (null).
RetryDelayMilliseconds Optionaler Int32-Parameter.

Gibt die Verzögerung zwischen jeglichen erforderlichen Wiederholungen in Millisekunden an. Diese wird standardmäßig auf 5000 festgelegt.
SkipUnchangedFiles Optionaler Boolean-Parameter.

Wenn true festgelegt ist, wird das Herunterladen der unveränderten Dateien übersprungen. Wird standardmäßig auf true festgelegt. In der DownloadFile-Aufgabe werden Dateien als unverändert betrachtet, wenn sie laut dem Remoteserver dieselbe Größe aufweisen und zur selben Zeit zuletzt geändert wurden.

Hinweis: Nicht alle HTTP-Server geben das letzte Änderungsdatum von Dateien an. Dadurch wird die Datei erneut heruntergeladen.
SourceUrl Erforderlicher String-Parameter.

Gibt die URL für den Download an.

Hinweise

Zusätzlich zu den oben aufgeführten Parametern erbt diese Aufgabe Parameter von der TaskExtension-Klasse, die selbst von der Task-Klasse erbt. Eine Liste mit diesen zusätzlichen Parametern und ihren Beschreibungen finden Sie unter TaskExtension-Basisklasse.

Beispiel

In folgendem Beispiel wird eine Datei heruntergeladen und in die Content-Elemente eingeschlossen, bevor das Projekt erstellt wird.

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

Weitere Informationen