DownloadFile (Tarea)

Descarga los archivos especificados mediante el protocolo de transferencia de Hyper-Text (HTTP).

Nota:

La tarea DownloadFile solo está disponible en MSBuild 15.8 y versiones posteriores.

Parámetros

En la tabla siguiente se describen los parámetros de la DownloadFile tarea.

Parámetro	Descripción
DestinationFileName	Parámetro opcional ITaskItem Nombre que se va a usar para el archivo descargado. De forma predeterminada, el nombre de archivo se deriva del SourceUrl servidor remoto o .
DestinationFolder	Parámetro obligatorio ITaskItem . Especifica la carpeta de destino en la que descargar el archivo. La carpeta se crea si no existe.
DownloadedFile	Parámetro de salida opcional ITaskItem . Especifica el archivo que se descargó.
Retries	Parámetro opcional Int32 . Especifica cuántas veces se intenta descargar, si se han producido errores en todos los intentos anteriores. El valor predeterminado es cero.
RetryDelayMilliseconds	Parámetro opcional Int32 . Especifica el retraso en milisegundos entre los reintentos necesarios. Tiene como valor predeterminado 5000.
SkipUnchangedFiles	Parámetro opcional Boolean . Si truees , omite la descarga de archivos sin cambios. Tiene como valor predeterminado true. La DownloadFile tarea considera que los archivos no se modifican si tienen el mismo tamaño y la misma hora de última modificación según el servidor remoto. Nota: No todos los servidores HTTP indican la fecha de última modificación de los archivos hará que el archivo se descargue de nuevo.
SourceUrl	Parámetro obligatorio String . Especifica la dirección URL que se va a descargar.

Observaciones

Además de los parámetros enumerados anteriormente, esta tarea hereda los parámetros de la TaskExtension clase , que en sí hereda de la Task clase . Para obtener una lista de estos parámetros adicionales y sus descripciones, vea Clase base TaskExtension.

Ejemplo

En el ejemplo siguiente se descarga un archivo y se incluye en los Content elementos antes de compilar el proyecto.

<Project>

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

Consulte también

• Tareas
• Referencia de tareas