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.
Lädt die angegebenen Dateien mithilfe des Hyper-Text Transfer Protocol (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 des DownloadFile Vorgangs beschrieben.
| Parameter | Beschreibung |
|---|---|
DestinationFileName |
Optionaler ITaskItem Parameter Der Name, der für die heruntergeladene Datei verwendet werden soll. Standardmäßig wird der Dateiname vom Remoteserver oder vom SourceUrl Remoteserver abgeleitet. |
DestinationFolder |
Erforderlicher ITaskItem Parameter. Gibt den Zielordner an, in den die Datei heruntergeladen werden soll. Der Ordner wird erstellt, wenn er nicht vorhanden ist. |
DownloadedFile |
Optionaler ITaskItem Ausgabeparameter. Gibt die Datei an, die heruntergeladen wurde. |
Retries |
Optionaler Int32 Parameter.Gibt an, wie oft versucht werden soll, herunterzuladen, wenn alle vorherigen Versuche fehlgeschlagen sind. Der Standardwert ist null. |
RetryDelayMilliseconds |
Optionaler Int32 Parameter.Gibt die Verzögerung in Millisekunden zwischen allen erforderlichen Wiederholungen an. Dieser wird standardmäßig auf 5000 festgelegt. |
SkipUnchangedFiles |
Optionaler Boolean Parameter.Wenn true, überspringt das Herunterladen von Dateien, die unverändert sind. Wird standardmäßig auf true festgelegt. Die DownloadFile Aufgabe berücksichtigt, dass Dateien unverändert bleiben, wenn sie die gleiche Größe und die gleiche zeit der letzten Änderung entsprechend dem Remoteserver haben. Hinweis: Nicht alle HTTP-Server deuten darauf hin, dass das Datum der letzten Änderung der Dateien erneut heruntergeladen wird. |
SourceUrl |
Erforderlicher String Parameter.Gibt die URL an, die heruntergeladen werden soll. |
Bemerkungen
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 dieser zusätzlichen Parameter und deren Beschreibungen finden Sie unter TaskExtension-Basisklasse.
Beispiel
Im folgenden Beispiel wird eine Datei heruntergeladen und in die Elemente vor dem Content Erstellen des Projekts eingeschlossen.
<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>