Attività DownloadFile

  • Articolo

Consente di scaricare i file specificati usando Hypertext Transfer Protocol (HTTP).

Nota

L'attività DownloadFile è disponibile solo in MSBuild 15.8 e versioni successive.

Parametri

Nella tabella che segue vengono descritti i parametri dell'attività DownloadFile.

Parametro Descrizione
DestinationFileName Parametro ITaskItem facoltativo

Nome da usare per il file scaricato. Per impostazione predefinita, il nome del file è derivato dall'elemento SourceUrl o server remoto.
DestinationFolder Parametro ITaskItem obbligatorio.

Specifica la cartella di destinazione in cui scaricare il file. Se non esiste, la cartella viene creata.
DownloadedFile Parametro di output ITaskItem facoltativo.

Specifica il file scaricato.
Retries Parametro Int32 facoltativo.

Specifica il numero di tentativi da eseguire per il download, se tutti i tentativi precedenti hanno avuto esito negativo. Il valore predefinito è zero.
RetryDelayMilliseconds Parametro Int32 facoltativo.

Specifica il ritardo in millisecondi tra eventuali nuovi tentativi necessari. Il valore predefinito è 5000.
SkipUnchangedFiles Parametro Boolean facoltativo.

Se true, ignora il download dei file invariati. Il valore predefinito è true. L'attività DownloadFile considera invariati i file con le stesse dimensioni e la stessa ora dell'ultima modifica secondo il server remoto.

Nota: se non tutti i server HTTP indicano la data dell'ultima modifica dei file, il file verrà scaricato nuovamente.
SourceUrl Parametro String obbligatorio.

Specifica l'URL da scaricare.

Osservazioni:

Oltre ai parametri elencati sopra, questa attività eredita i parametri dalla classe TaskExtension, che a sua volta eredita dalla classe Task. Per un elenco di questi parametri aggiuntivi e le rispettive descrizioni, vedere TaskExtension Base Class.

Esempio

Nell'esempio seguente viene scaricato un file e incluso negli elementi Content prima della compilazione del progetto.

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

Vedi anche