Elemento Target (MSBuild)
Actualización: noviembre 2007
Contiene un conjunto de tareas para MSBuild que se ejecutarán secuencialmente.
<Target Name="Target Name"
DependsOnTargets="DependentTarget"
Inputs="Inputs"
Outputs="Outputs"
Condition="'String A' == 'String B'">
<Task>... </Task>
<OnError... />
</Target>
Atributos y elementos
En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.
Atributos
Atributo |
Descripción |
|---|---|
Name |
Atributo necesario. Nombre del destino. |
DependsOnTargets |
Atributo opcional. Destinos que se deben ejecutar antes de que este destino pueda ejecutarse o que tenga lugar el análisis de dependencia de nivel superior. Los destinos múltiples están separados con puntos y coma. |
Inputs |
Atributo opcional. Entradas de elemento para este destino. Los elementos de este atributo se utilizan como entrada en el análisis de dependencia de nivel superior. |
Outputs |
Atributo opcional. Resultados esperados de este destino. Se pueden aplicar transformaciones a los elementos de entrada para generar los elementos de salida. Para obtener más información, vea Transformaciones de MSBuild. |
Condition |
Atributo opcional. Condición que se va a evaluar. Si la condición se evalúa como false, el destino no ejecutará el cuerpo del destino o cualquier destino establecido en el atributo DependsOnTargets. Para obtener más información sobre las condiciones, vea Condiciones de MSBuild. |
Elementos secundarios
Elemento |
Descripción |
|---|---|
Crea y ejecuta una instancia de una tarea de MSBuild. Puede haber cero o más tareas en un destino. |
|
Hace que uno o varios destinos se ejecuten si el atributo ContinueOnError es false para una tarea que ha fallado. Puede haber cero o más elementos OnError en un destino. Si están presentes elementos OnError, deben ser los últimos elementos en el elemento Target. |
Elementos primarios
Elemento |
Descripción |
|---|---|
Elemento raíz requerido de un archivo de proyecto MSBuild. |
Comentarios
El primer destino que se ejecutará se especifica en el tiempo de ejecución. Los destinos pueden tener dependencias en otros destinos. Por ejemplo, un destino para la implementación depende de un destino para la compilación. El motor de MSBuild ejecuta las dependencias en el orden en que aparecen en el atributo DependsOnTargets de izquierda a derecha. Para obtener más información, vea Objetivos de MSBuild.
Un destino sólo se ejecuta una vez durante una generación, incluso si dependen del mismo más de un destino.
Si se omite un destino porque su atributo Condition se evalúa como false, todavía se puede ejecutar si se invoca más adelante durante la generación, y su atributo Condition se evalúa como true en dicho momento.
Ejemplo
El siguiente ejemplo de código muestra un elemento Target que ejecuta la tarea Csc.
<Target Name="Compile" DependsOnTarget="Resources" >
<Csc Sources="@(CSFile)"
TargetType="library"
Resources="@(CompiledResources)"
EmitDebugInformation="$(includeDebugInformation)"
References="@(Reference)"
DebugType="$(debuggingType)" >
<Output TaskParameter="OutputAssembly"
ItemName="FinalAssemblyName" />
</Csc>
</Target>