共用方式為

DownloadFile 工作

  • 發行項

使用超文字傳輸通訊協定 (HTTP)，下載指定的檔案。

注意

DownloadFile 工作僅適用於 MSBuild 15.8 和更新版本。

參數

下表說明 DownloadFile 工作的參數。

參數 描述
DestinationFileName 選擇性的 ITaskItem 參數

要用於已下載檔案的名稱。 根據預設，檔案名稱衍生自 SourceUrl 或遠端伺服器。
DestinationFolder 必要的 ITaskItem 參數。

指定檔案下載的目的地資料夾。 如果資料夾不存在，則會予以建立。
DownloadedFile 選擇性的 ITaskItem 輸出參數。

指定已下載的檔案。
Retries 選擇性的 Int32 參數。

指定如果所有先前的嘗試均失敗，要嘗試下載多少次。 預設值為零。
RetryDelayMilliseconds 選擇性的 Int32 參數。

指定任何必要重試之間的延遲 (毫秒)。 預設值為 5000。
SkipUnchangedFiles 選擇性的 Boolean 參數。

如果 true，則會略過下載未變更的檔案。 預設為 true。 如果檔案根據遠端伺服器而具有相同的大小和相同的上次修改時間，DownloadFile 工作即會將檔案視為未變更。

注意：並非所有 HTTP 伺服器都指出檔案的上次修改日期會再次下載檔案。
SourceUrl 必要的 String 參數。

指定要下載的 URL。

備註

除了上述所列的參數，此項工作還會繼承 TaskExtension 類別中的參數，而該類別本身又繼承 Task 類別。 如需這些其他參數的清單及其描述，請參閱 TaskExtension 基底類別。

範例

下列範例會下載檔案，並在建置專案之前將它包含在 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>

另請參閱