Elemento Item (MSBuild)
Contiene un elemento definido por el usuario y sus metadatos.Todos los elementos utilizados en un proyecto de MSBuild deben especificarse como elementos secundarios de un elemento ItemGroup.
<Item Include="*.cs"
Exclude="MyFile.cs"
Remove="RemoveFile.cs"
Condition="'String A'=='String B'" >
<ItemMetadata1>...</ItemMetadata1>
<ItemMetadata2>...</ItemMetadata2>
</Item>
Atributos y elementos
En las próximas secciones se describen los atributos, los elementos secundarios y los elementos primarios.
Atributos
Atributo |
Descripción |
|---|---|
Include |
Atributo necesario. El archivo o comodín que se desea incluir en la lista de elementos. |
Exclude |
Atributo opcional. El archivo o comodín que se desea excluir de la lista de elementos. |
Condition |
Atributo opcional. La condición que se va a evaluar.Para obtener más información, vea Condiciones de MSBuild. |
Remove |
Atributo opcional. El archivo o comodín que se desea quitar de la lista de elementos. Este atributo sólo es válido si ha especificado para un elemento en ItemGroup que está en Target. |
KeepMetadata |
Atributo opcional. Los metadatos para los elementos de origen agregar elementos de destino.Sólo los metadatos cuyos nombres se especifican en la lista delimitada por punto y coma se transfieren de un elemento de origen a un elemento de destino.Para obtener más información, vea Elementos de MSBuild. Este atributo sólo es válido si ha especificado para un elemento en ItemGroup que está en Target. |
RemoveMetadata |
Atributo opcional. Los metadatos para los elementos de origen no transfieran a los elementos de destino.Todos los metadatos se transfieren de un elemento de origen a un elemento de destino excepto los metadatos cuyos nombres contiene la lista delimitada por puntos y comas de nombres.Para obtener más información, vea Elementos de MSBuild. Este atributo sólo es válido si ha especificado para un elemento en ItemGroup que está en Target. |
KeepDuplicates |
Atributo opcional. Especifica si un elemento se debe agregar al grupo destino si es un duplicado exacto de un elemento existente.Si el elemento de origen y de destino tiene el mismo valor Include pero distintos metadatos, se agrega el elemento aunque KeepDuplicates se establece en false.Para obtener más información, vea Elementos de MSBuild. Este atributo sólo es válido si ha especificado para un elemento en ItemGroup que está en Target. |
Elementos secundarios
Elemento |
Descripción |
|---|---|
Clave de metadatos de elemento definida por el usuario, que contiene el valor de metadatos del elemento.Puede haber cero o más elementos ItemMetadata en un elemento. |
Elementos primarios
Elemento |
Descripción |
|---|---|
Elemento de agrupación para los elementos. |
Comentarios
Los elementos Item definen las entradas en el sistema de compilación y se agrupan en colecciones de elementos basadas en sus nombres de colección definidos por el usuario.Estas colecciones de elementos se pueden utilizar como parámetros para tareas, que utilizan los elementos individuales contenidos en las colecciones para realizar los pasos del proceso de compilación.Para obtener más información, vea Elementos de MSBuild.
El uso de la notación @(myType) permite que una colección de elementos de tipo myType se amplíe a una lista de cadenas delimitadas mediante punto y coma, y se pase al parámetro.Si el parámetro es de tipo string, el valor del parámetro es la lista de elementos separada por punto y coma.Si el parámetro es una matriz de cadenas (string[]), cada elemento se inserta en la matriz en función de la ubicación de los punto y coma.Si el parámetro de tarea es de tipo ITaskItem[], el valor es el contenido de la colección de elementos junto con los metadatos adjuntos.Para delimitar cada elemento mediante un carácter que no sea un punto y coma, utilice la sintaxis @(myType, 'separator').
El motor de MSBuild puede evaluar caracteres comodín como * y ? y comodines recursivos como /**/*.cs.Para obtener más información, vea Elementos de MSBuild.
Ejemplo
El siguiente ejemplo de código muestra cómo declarar dos elementos de tipo CSFile.El segundo elemento declarado contiene metadatos que tienen myAttribute establecido en HelloWorld.
<ItemGroup>
<CSFile Include="engine.cs; form.cs" />
<CSFile Include="main.cs" >
<MyMetadata>HelloWorld</MyMetadata>
</CSFile>
</ItemGroup>