Output-Element (MSBuild)

Artikel
10/13/2023

Speichert Aufgabenausgabewerte in Elementen und Eigenschaften.

Syntax

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

Attribut	Beschreibung
`TaskParameter`	Erforderliches Attribut. Der Name des Ausgabeparameters der Aufgabe.
`PropertyName`	Entweder ist Attribut `PropertyName` oder Attribut `ItemName` erforderlich. Die Eigenschaft, die den Ausgabeparameterwert der Aufgabe empfängt. Das Projekt kann dann mit der $(<PropertyName>)-Syntax auf die Eigenschaft verweisen. Dieser Eigenschaftsname kann entweder ein neuer Eigenschaftsname oder ein Name sein, der bereits im Projekt definiert ist. Dieses Attribut kann nicht verwendet werden, wenn `ItemName` auch verwendet wird.
`ItemName`	Entweder ist Attribut `PropertyName` oder Attribut `ItemName` erforderlich. Das Element, das den Ausgabeparameterwert der Aufgabe empfängt. Das Projekt kann dann mit der @(<ItemName>)-Syntax auf das Element verweisen. Der Name des Elements kann entweder ein neuer Elementname oder ein Name sein, der bereits im Projekt definiert ist. Wenn es sich bei dem Elementnamen um ein bereits vorhandenes Element handelt, werden die Ausgabeparameterwerte zum bereits vorhandenen Element hinzugefügt. Dieses Attribut kann nicht verwendet werden, wenn `PropertyName` auch verwendet wird.
`Condition`	Optionales Attribut. Die auszuwertende Bedingung. Weitere Informationen finden Sie unter Conditions (MSBuild-Bedingungen).

Untergeordnete Elemente

Keine

Übergeordnete Elemente

Element	Beschreibung
Aufgabe	Erstellt und führt eine Instanz einer MSBuild-Aufgabe aus.

Beispiel

Das folgende Codebeispiel zeigt die Ausführung einer Csc-Aufgabe innerhalb eines Target-Elements. Die Elemente und Eigenschaften, die den Aufgabeparametern übergeben werden, werden außerhalb des Bereichs dieses Beispiels deklariert. Der Wert des Ausgabeparameters OutputAssembly wird im FinalAssemblyName-Element gespeichert, und der Wert des Ausgabeparameters BuildSucceeded wird in der BuildWorked-Eigenschaft gespeichert. Weitere Informationen finden Sie unter MSBuild-Aufgaben.

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