Partager via


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.

Paramètres

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.

Notes

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.

Exemple

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>

Voir aussi