DownloadFile görevi

  • Makale

Belirtilen dosyaları Hyper-Text Transfer Protocol (HTTP) kullanarak indirir.

Dekont

DownloadFile görevi yalnızca MSBuild 15.8 ve üzeri sürümlerde kullanılabilir.

Parametreler

Aşağıdaki tabloda görevin parametreleri DownloadFile açıklanmaktadır.

Parametre Tanım
DestinationFileName İsteğe bağlı ITaskItem parametre

İndirilen dosya için kullanılacak ad. Varsayılan olarak, dosya adı veya uzak sunucudan SourceUrl türetilir.
DestinationFolder Gerekli ITaskItem parametresi.

Dosyanın indirilmesi için hedef klasörü belirtir. Klasör yoksa oluşturulursa.
DownloadedFile İsteğe bağlı ITaskItem çıkış parametresi.

İndirilen dosyayı belirtir.
Retries İsteğe bağlı Int32 parametre.

Önceki tüm girişimlerin başarısız olması durumunda indirme girişiminde kaç kez çalışılıp denenmediğini belirtir. Varsayılan olarak sıfırdır.
RetryDelayMilliseconds İsteğe bağlı Int32 parametre.

Gerekli yeniden denemeler arasındaki gecikmeyi milisaniye cinsinden belirtir. Varsayılan değer 5000'tir.
SkipUnchangedFiles İsteğe bağlı Boolean parametre.

ise true, değişmeyen dosyaların indirilmesini atlar. varsayılan değeridir true. Görev, DownloadFile uzak sunucuya göre aynı boyuta ve aynı son değiştirme zamanına sahipse dosyaların değiştirilmediğini dikkate alır.

Not: Tüm HTTP sunucuları dosyaların son değiştirilme tarihinin dosyanın yeniden indirilmesine neden olacağını göstermez.
SourceUrl Gerekli String parametresi.

İndirilmesi gereken URL'yi belirtir.

Açıklamalar

Yukarıda listelenen parametrelere ek olarak, bu görev kendi sınıfından TaskExtension devralan sınıfından Task parametreleri devralır. Bu ek parametrelerin ve açıklamalarının listesi için bkz . TaskExtension temel sınıfı.

Örnek

Aşağıdaki örnek bir dosyayı indirir ve projeyi oluşturmadan önce öğelere ekler Content .

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

Ayrıca bkz.