Elemento Output (MSBuild)

Artículo
06/19/2023

Almacena valores de salida de tarea en elementos y propiedades.

Sintaxis

<Output TaskParameter="Parameter"
    PropertyName="PropertyName"
    Condition = "'String A' == 'String B'" />

Atributos y elementos

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo	Descripción
`TaskParameter`	Atributo necesario. El nombre del parámetro de salida de la tarea.
`PropertyName`	Se necesita el atributo `PropertyName` o `ItemName`. La propiedad que recibe el valor del parámetro de salida de la tarea. Después, el proyecto puede hacer referencia a la propiedad con la sintaxis $(<PropertyName>). Este nombre de propiedad puede ser un nuevo nombre de propiedad o un nombre que ya está definido en el proyecto. Este atributo no se puede usar si `ItemName` también se utiliza.
`ItemName`	Se necesita el atributo `PropertyName` o `ItemName`. El elemento que recibe el valor del parámetro de salida de la tarea. Después, el proyecto puede hacer referencia al elemento con la sintaxis @(<ItemName>). El nombre de elemento puede ser un nuevo nombre de elemento o un nombre que ya está definido en el proyecto. Cuando el nombre de elemento es un elemento existente, los valores del parámetro de salida se agregan al elemento existente. Este atributo no se puede usar si `PropertyName` también se utiliza.
`Condition`	Atributo opcional. Condición que se va a evaluar. Para obtener más información, consulte Condiciones.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento	Descripción
Task	Crea y ejecuta una instancia de una tarea de MSBuild.

Ejemplo

En el siguiente ejemplo de código se muestra la tarea Csc que se ejecuta dentro de un elemento Target. Los elementos y las propiedades que se pasan a los parámetros de tarea se declaran fuera del ámbito de este ejemplo. El valor del parámetro de salida OutputAssembly se almacena en el FinalAssemblyName elemento y el valor del parámetro de salida BuildSucceeded se almacena en la propiedad BuildWorked. Para obtener más información, consulte Tareas.

<Target Name="Compile" DependsOnTargets="Resources">
    <Csc  Sources="@(CSFile)"
            TargetType="library"
            Resources="@(CompiledResources)"
            EmitDebugInformation="$(includeDebugInformation)"
            References="@(Reference)"
            DebugType="$(debuggingType)"
            OutputAssembly="$(builtdir)\$(MSBuildProjectName).dll" >
        <Output TaskParameter="OutputAssembly"
                  ItemName="FinalAssemblyName" />
        <Output TaskParameter="BuildSucceeded"
                  PropertyName="BuildWorked" />
    </Csc>
</Target>