Élément Output (MSBuild)

Article
06/19/2023

Stocke les valeurs de sortie d’une tâche dans les éléments et les propriétés.

Syntaxe

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut	Description
`TaskParameter`	Attribut requis. Nom du paramètre de sortie de la tâche.
`PropertyName`	L’attribut `PropertyName` ou `ItemName` est obligatoire. Propriété recevant la valeur du paramètre de sortie de la tâche. Votre projet peut alors faire référence à la propriété avec la syntaxe $(<nom_propriété>). Ce nom de propriété peut être un nouveau nom de propriété ou un nom déjà défini dans le projet. Cet attribut n’est pas utilisable si `ItemName` est également utilisé.
`ItemName`	L’attribut `PropertyName` ou `ItemName` est obligatoire. Élément recevant la valeur du paramètre de sortie de la tâche. Votre projet peut alors faire référence à l’élément avec la syntaxe @(<nom_élément>). Ce nom d’élément peut être un nouveau nom d’élément ou un nom déjà défini dans le projet. Quand le nom d’élément est un élément existant, les valeurs de paramètre de sortie sont ajoutées à l’élément existant. Cet attribut n’est pas utilisable si `PropertyName` est également utilisé.
`Condition`	Attribut facultatif. Condition à évaluer. Pour plus d’informations, consultez l’article Conditions (Conditions MSBuild).

Éléments enfants

Aucune.

Éléments parents

Élément	Description
Tâche	Crée et exécute une instance d’une tâche MSBuild.

Exemple

L’exemple de code ci-après présente l’exécution de la tâche Csc au sein d’un élément Target. Les éléments et propriétés transmis aux paramètres de la tâche sont déclarés en dehors de la portée de cet exemple. La valeur du paramètre de sortie OutputAssembly est stockée dans l’élément FinalAssemblyName, et la valeur du paramètre de sortie BuildSucceeded est stockée dans la propriété BuildWorked. Pour plus d’informations, consultez l’article Tâches MSBuild.

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

Partager via