TARGETS-Dateien von MSBuild

  • Artikel

MSBuild umfasst mehrere TARGETS-Dateien, die Elemente, Eigenschaften, Ziele und Aufgaben für allgemeine Szenarien enthalten. Diese Dateien werden in die meisten Visual Studio-Projektdateien automatisch importiert, um Lesbarkeit und Verwaltung zu vereinfachen.

Projekte importieren in der Regel mindestens eine TARGETS-Datei, um den entsprechenden Buildprozess zu definieren. Beispielweise importiert ein mit Visual Studio erstelltes C#-Projekt die Datei Microsoft.CSharp.targets, die wiederum Microsoft.Common.targets importiert. Das C#-Projekt selbst definiert die jeweiligen Elemente und Eigenschaften dieses Projekts. Die standardmäßigen Buildregeln für ein C#-Projekt werden jedoch in den importierten TARGETS-Dateien definiert.

Der $(MSBuildToolsPath)-Wert gibt den Pfad dieser allgemeinen TARGETS-Dateien an. Für ToolsVersion 4.0 befinden die Dateien sich an folgendem Speicherort: <WindowsInstallationPath>\Microsoft.NET\Framework\v4.0.30319\

Hinweis

Informationen zum Erstellen eigener Ziele finden Sie unter Targets (MSBuild-Ziele). Wie Sie mithilfe des Import-Elements eine Projektdatei in eine andere Projektdatei einfügen können, wird unter Import-Element (MSBuild) und Vorgehensweise: Verwenden desselben Ziels in mehreren Projektdateien erklärt.

Allgemeine TARGETS-Dateien

TARGETS-Datei Beschreibung
Microsoft.Common.targets Definiert die Schritte im Standardbuildprozess für Visual Basic- und C#-Projekte.

Wird von Microsoft.CSharp.targets-Dateien und Microsoft.VisualBasic.targets-Dateien importiert, die die folgende Anweisung enthalten: <Import Project="Microsoft.Common.targets" />
Microsoft.CSharp.targets Definiert die Schritte im Standardbuildprozess für Visual C#-Projekte.

Wird von Visual C#-Projektdateien (CSPROJ) importiert, die die folgende Anweisung enthalten: <Import Project="$(MSBuildToolsPath)\Microsoft.CSharp.targets" />
Microsoft.VisualBasic.targets Definiert die Schritte im Standardbuildprozess für Visual Basic-Projekte.

Wird von Visual Basic-Projektdateien (VBPROJ) importiert, die die folgende Anweisung enthalten: <Import Project="$(MSBuildToolsPath)\Microsoft.VisualBasic.targets" />

Directory.Build.targets

Bei Directory.Build.targets handelt es sich um eine benutzerdefinierte Datei, die Anpassungen für Projekte in einem Verzeichnis bereitstellt. Diese Datei wird automatisch aus Microsoft.Common.targets importiert, wenn die Eigenschaft ImportDirectoryBuildTargets nicht auf FALSE festgelegt wird. Weitere Informationen finden Sie unter Anpassen des Builds.

Siehe auch