Bagikan melalui

Tugas DownloadFile

  • Artikel

Mengunduh file yang ditentukan menggunakan Protokol Transfer Hiperteks (HTTP).

Catatan

Tugas DownloadFile hanya tersedia di MSBuild 15.8 ke atas.

Parameter

Tabel berikut ini menjelaskan parameter tugas DownloadFile.

Parameter Deskripsi
DestinationFileName Parameter ITaskItem opsional

Nama yang digunakan untuk file yang diunduh. Secara default, nama file berasal dari SourceUrl atau server jarak jauh.
DestinationFolder Parameter ITaskItem wajib.

Menentukan folder tujuan untuk mengunduh file. Jika folder dibuat jika tidak ada.
DownloadedFile Parameter output ITaskItem opsional.

Menentukan file yang diunduh.
Retries Parameter Int32 opsional.

Menentukan berapa kali mencoba mengunduh, jika semua upaya sebelumnya gagal. Default ke nol.
RetryDelayMilliseconds Parameter Int32 opsional.

Menentukan penundaan dalam milidetik antara percobaan ulang yang diperlukan. Default ke 5000.
SkipUnchangedFiles Parameter Boolean opsional.

Jika true, lewati pengunduhan file yang tidak berubah. Default ke true. Tugas ini DownloadFile menganggap file tidak berubah jika memiliki ukuran yang sama dan waktu modifikasi terakhir yang sama sesuai dengan server jarak jauh.

Catatan: Tidak semua server HTTP menunjukkan tanggal terakhir file yang dimodifikasi akan menyebabkan file diunduh lagi.
SourceUrl Parameter String wajib.

Menentukan URL yang akan diunduh.

Keterangan

Selain parameter yang tercantum di atas, tugas ini mewarisi parameter dari kelas TaskExtension, yang mewarisi sendiri dari kelas Task. Untuk daftar parameter tambahan ini dan deskripsinya, lihat kelas dasar TaskExtension.

Contoh

Contoh berikut mengunduh file dan menyertakannya dalam Content item sebelum membangun proyek.

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

Baca juga