Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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>
<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>