Compartir a través de


Procesamiento por lotes de MSBuild

MSBuild tiene la capacidad de dividir las listas de elementos en distintas categorías, o lotes, basándose en los metadatos de estos elementos, y luego ejecutar un destino o una tarea una vez con cada lote.

Procesamiento por lotes de tareas

El procesamiento por lotes de tareas permite simplificar los archivos del proyecto al facilitar un modo de dividir las listas de elementos en diferentes lotes y pasar cada uno de ellos a una tarea por separado.Esto significa que un archivo de proyecto sólo tiene que declarar una vez la tarea y sus atributos, aunque se pueda ejecutar varias veces.

Es posible especificar que se desea que MSBuild realice el procesamiento por lotes con una tarea mediante la notación %(nombreDeMetadatosDeElemento) en uno de los atributos de la tarea.En el ejemplo siguiente, se divide la lista de elementos Example en lotes basándose en el valor de los metadatos del elemento Color, y se pasa cada lote a la tarea MyTask por separado.

[!NOTA]

Si no se hace referencia a la lista de elementos en ninguna parte de los atributos de la tarea o si el nombre de los metadatos es ambiguo, se podrá usar la notación %(colecciónDeElementos.nombreDeMetadatosDeElemento) para que el valor de los metadatos de elementos tenga un nombre completo que se pueda utilizar en el procesamiento por lotes.

<Project
    xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
    
    <ItemGroup>
        <Example Include="Item1">
            <Color>Blue</Color>
        </Example>
        <Example Include="Item2">
            <Color>Red</Color>
        </Example>
    </ItemGroup>

    <Target Name="RunMyTask">
        <MyTask
            Sources = "@(Example)"
            Output = "%(Color)\MyFile.txt"/>
    </Target>

</Project>

Para obtener ejemplos sobre el procesamiento por lotes más concretos, vea Metadatos de elementos en el procesamiento por lotes de tareas.

Procesamiento por lotes de destinos

MSBuild comprueba si las entradas y los resultados de un destino están actualizados antes de ejecutar el destino.Si las entradas y los resultados están actualizados, se omite el destino.Si una tarea incluida en un destino usa el procesamiento por lotes, MSBuild debe determinar si las entradas y los resultados de cada lote de elementos están actualizados.De lo contrario, el destino se ejecutará cada vez que se alcance.

En el ejemplo siguiente se muestra un elemento Target que contiene un atributo Outputs con la notación %(nombreDeMetadatosDeElemento).MSBuild dividirá la lista de elementos Example en lotes basándose en los metadatos de elementos Color y analizará las marcas de tiempo de los archivos de salida para cada lote.Si los resultados de un lote no están actualizados, se ejecutará el destino.De lo contrario, se omitirá el destino.

<Project
    xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
    
    <ItemGroup>
        <Example Include="Item1">
            <Color>Blue</Color>
        </Example>
        <Example Include="Item2">
            <Color>Red</Color>
        </Example>
    </ItemGroup>

    <Target Name="RunMyTask"
        Inputs="@(Example)"
        Outputs="%(Color)\MyFile.txt">
        <MyTask
            Sources = "@(Example)"
            Output = "%(Color)\MyFile.txt"/>
    </Target>

</Project>

Para obtener otro ejemplo de procesamiento por lotes de destinos, vea Metadatos de elementos en procesamiento por lotes de destinos.

Funciones de propiedad con metadatos

El procesamiento por lotes se puede controlar mediante funciones de propiedad que incluyen metadatos.Por ejemplo,

$([System.IO.Path]::Combine($(RootPath),%(Compile.Identity)))

usa Combine para combinar una ruta de acceso a la carpeta raíz con una ruta de acceso al elemento Compile.

Las funciones de propiedad no pueden aparecer en los valores de los metadatos.Por ejemplo,

%(Compile.FullPath.Substring(0,3))

no se permite.

Para obtener más información acerca de las funciones de propiedad, vea Funciones de propiedad.

Vea también

Referencia

Elemento ItemMetadata (MSBuild)

Otros recursos

Conceptos de MSBuild

Referencia de MSBuild

Conceptos avanzados de MSBuild