Output-Element (MSBuild)

Artikel
06/09/2015

Speichert Aufgabenausgabewerte in Elementen und Eigenschaften.

<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 das PropertyName-Attribut oder das ItemName-Attribut ist erforderlich. Die Eigenschaft, die den Ausgabeparameterwert der Aufgabe empfängt. Das Projekt kann dann mit der Syntax $(PropertyName) auf die Eigenschaft verweisen. Dieser Eigenschaftenname kann entweder ein neuer Eigenschaftenname oder ein im Projekt bereits definierter Name sein. Dieses Attribut kann nicht verwendet werden, wenn ItemName ebenfalls verwendet wird.
ItemName	Entweder das PropertyName-Attribut oder das ItemName-Attribut ist erforderlich. Das Element, das den Ausgabeparameterwert der Aufgabe empfängt. Das Projekt kann dann mit der Syntax @(ItemName) auf das Element verweisen. Der Elementname kann entweder ein neuer Elementname oder ein im Projekt bereits definierter Name sein. Dieses Attribut kann nicht verwendet werden, wenn PropertyName ebenfalls verwendet wird.
Condition	Optionales Attribut. Die auszuwertende Bedingung. Weitere Informationen finden Sie unter MSBuild-Bedingungen.

Untergeordnete Elemente

Keine.

Übergeordnete Elemente

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

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie die Csc-Aufgabe innerhalb eines Target-Elements ausgeführt wird. Die Deklaration der an die Aufgabenparameter übergebenen Elemente und Eigenschaften ist in diesem Beispiel nicht enthalten. Der Wert des Ausgabeparameters OutputAssembly wird im FinalAssemblyName-Element gespeichert, der Wert des Ausgabeparameters BuildSucceeded in der BuildWorked-Eigenschaft. 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>

Siehe auch

Konzepte

Referenz zum MSBuild-Projektdateischema

MSBuild-Aufgaben

Freigeben über