DownloadFile, tâche
Télécharge les fichiers spécifiés à l’aide du protocole HTTP (Hyper-Text Transfer Protocol).
Notes
La tâche DownloadFile est disponible dans MSBuild 15.8 et versions ultérieures uniquement.
Le tableau ci-dessous décrit les paramètres de la tâche DownloadFile
.
Paramètre | Description |
---|---|
DestinationFileName |
Paramètre ITaskItem facultatif. Nom à utiliser pour le fichier téléchargé. Par défaut, le nom de fichier est dérivé de SourceUrl ou du serveur distant. |
DestinationFolder |
Paramètre ITaskItem requis. Spécifie le dossier de destination dans lequel télécharger le fichier. Le dossier est créé s’il n’existe pas. |
DownloadedFile |
Paramètre de sortie ITaskItem facultatif. Spécifie le fichier qui a été téléchargé. |
Retries |
Paramètre Int32 facultatif.Spécifie le nombre de tentatives de téléchargement, si toutes les tentatives précédentes ont échoué. La valeur par défaut est zéro. |
RetryDelayMilliseconds |
Paramètre Int32 facultatif.Spécifie le délai en millisecondes entre les tentatives nécessaires. La valeur par défaut est 5 000. |
SkipUnchangedFiles |
Paramètre Boolean facultatif.Si la valeur est true , ignore le téléchargement des fichiers qui sont inchangés. La valeur par défaut est true . La tâche DownloadFile considère que les fichiers sont inchangés s’ils ont la même taille et la même heure de dernière modification selon le serveur distant. Remarque : les serveurs HTTP n’indiquent pas tous la date de dernière modification des fichiers, ce qui entraîne un nouveau téléchargement du fichier. |
SourceUrl |
Paramètre String requis.Spécifie l’URL à télécharger. |
En plus des paramètres énumérés ci-dessus, cette tâche hérite des paramètres de la classe TaskExtension , qui elle-même hérite de la classe Task . Pour obtenir la liste de ces paramètres supplémentaires et leurs descriptions, consultez Classe de base TaskExtension.
L’exemple suivant télécharge un fichier et l’inclut dans les éléments Content
avant de générer le projet.
<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>