DownloadFile, zadanie

  • Artykuł

Pobiera określone pliki przy użyciu protokołu HTTP (Hyper-Text Transfer Protocol).

Uwaga

Zadanie DownloadFile jest dostępne tylko w programie MSBuild 15.8 lub nowszym.

Parametry

W poniższej tabeli opisano parametry DownloadFile zadania.

Parametr Opis
DestinationFileName Opcjonalny ITaskItem parametr

Nazwa do użycia dla pobranego pliku. Domyślnie nazwa pliku pochodzi z SourceUrl serwera zdalnego lub .
DestinationFolder Wymagany parametr interfejsu ITaskItem.

Określa folder docelowy do pobrania pliku. Jeśli folder zostanie utworzony, jeśli nie istnieje.
DownloadedFile Opcjonalny ITaskItem parametr wyjściowy.

Określa pobrany plik.
Retries Opcjonalny Int32 parametr.

Określa liczbę prób pobrania, jeśli wszystkie poprzednie próby nie powiodły się. Domyślnie przyjmuje wartość zero.
RetryDelayMilliseconds Opcjonalny Int32 parametr.

Określa opóźnienie w milisekundach między wszelkimi niezbędnymi ponownymi próbami. Wartość domyślna to 5000.
SkipUnchangedFiles Opcjonalny Boolean parametr.

Jeśli trueprogram pomija pobieranie plików bez zmian. Wartość domyślna to true. Zadanie DownloadFile uwzględnia pliki bez zmian, jeśli mają ten sam rozmiar i ten sam czas ostatniej modyfikacji zgodnie z serwerem zdalnym.

Uwaga: Nie wszystkie serwery HTTP wskazują, że data ostatniej modyfikacji plików spowoduje ponowne pobranie pliku.
SourceUrl Wymagany parametr interfejsu String.

Określa adres URL do pobrania.

Uwagi

Oprócz parametrów wymienionych powyżej to zadanie dziedziczy parametry z TaskExtension klasy, która sama dziedziczy z Task klasy. Aby uzyskać listę tych dodatkowych parametrów i ich opisy, zobacz TaskExtension, klasa bazowa.

Przykład

Poniższy przykład pobiera plik i dołącza go do Content elementów przed utworzeniem projektu.

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

Zobacz też