MSBuild-Zielframework und Zielplattform

Ein Projekt kann für die Ausführung auf einem Zielframework erstellt werden, bei dem es sich um eine bestimmte Version von .NET Framework und eine Zielplattform handelt, bei der es sich um eine bestimmte Softwarearchitektur handelt. Sie können beispielsweise eine Anwendung für die Ausführung auf .NET Framework 2.0 auf einer 32-Bit-Plattform verwenden, die mit der 80x86-Prozessorfamilie ("x86") kompatibel ist. Die Kombination aus Zielframework und Zielplattform wird als Zielkontextbezeichnet.

Zielframework und -profil

Ein Zielframework ist die bestimmte Version von .NET Framework, auf der Ihr Projekt basiert, auf dem ausgeführt wird. Die Spezifikation eines Zielframeworks ist erforderlich, da es Compilerfeatures und Assemblyverweise ermöglicht, die für diese Version des Frameworks exklusiv sind.

Derzeit stehen die folgenden Versionen von .NET Framework zur Verfügung, obwohl einige von Microsoft nicht mehr unterstützt werden, und einige haben geplante zukünftige Daten, über die sie nicht mehr unterstützt werden. Die neuesten Supportinformationen finden Sie unter .NET Framework:

• .NET Framework 2.0 (enthalten in Visual Studio 2005)

• .NET Framework 3.0 (enthalten in Windows Vista)

• .NET Framework 3.5 (enthalten in Visual Studio 2008)

• .NET Framework 4.0

• .NET Framework 4.5.2

• .NET Framework 4.6 (enthalten in Visual Studio 2015)

• .NET Framework 4.6.1

• .NET Framework 4.6.2

• .NET Framework 4.7

• .NET Framework 4.7.1

• .NET Framework 4.7.2

• .NET Framework 4.8

Die Versionen von .NET Framework unterscheiden sich voneinander in der Liste der Assemblys, die jeweils für den Verweis verfügbar sind. Sie können beispielsweise keine WPF-Anwendungen (Windows Presentation Foundation) erstellen, es sei denn, Ihr Projekt ist auf .NET Framework, Version 3.0 oder höher ausgerichtet.

Das Zielframework wird in der TargetFrameworkVersion Eigenschaft in der Projektdatei angegeben. Sie können das Zielframework für ein Projekt mithilfe der Projekteigenschaftenseiten in der integrierten Entwicklungsumgebung (IDE) von Visual Studio ändern. Weitere Informationen finden Sie unter How to: Target a version of the .NET Framework. Die verfügbaren Werte sind TargetFrameworkVersionv2.0: , v3.0, v4.0, v3.5, v4.5.2, v4.6, , v4.6.1, v4.6.2, v4.7, v4.7.1, , , und v4.7.2v4.8.

<TargetFrameworkVersion>v4.0</TargetFrameworkVersion>

Ein Zielprofil ist eine Teilmenge eines Zielframeworks. Das .NET Framework 4-Clientprofil enthält beispielsweise keine Verweise auf die MSBuild-Assemblys.

Das Zielprofil wird in der TargetFrameworkProfile Eigenschaft in einer Projektdatei angegeben. Sie können das Zielprofil ändern, indem Sie das Zielframework-Steuerelement auf den Projekteigenschaftenseiten in der IDE verwenden.

<TargetFrameworkVersion>v4.0</TargetFrameworkVersion>
<TargetFrameworkProfile>Client</TargetFrameworkProfile>

Zielplattform

Eine Plattform ist eine Kombination aus Hardware und Software, die eine bestimmte Laufzeitumgebung definiert. Beispiel:

• x86 legt ein 32-Bit-Windows-Betriebssystem fest, das auf einem Intel 80x86-Prozessor oder seiner Entsprechung ausgeführt wird.
• x64 legt ein 64-Bit-Windows-Betriebssystem fest, das auf einem Intel x64-Prozessor oder seiner Entsprechung ausgeführt wird.
• anycpu legt die Ausgabe fest, die so konfiguriert ist, dass sie auf einer beliebigen Plattform ausgeführt werden kann. Ihre Anwendung wird nach Möglichkeit als 64-Bit-Prozess ausgeführt und wechselt zurück zu 32-Bit, wenn nur dieser Modus verfügbar ist.
• anycpu32bitpreferred bezeichnet die Ausgabe, die auf einer beliebigen Plattform ausgeführt wird. Die Anwendung wird auf Systemen, die sowohl 64-Bit- als auch 32-Bit-Anwendungen unterstützen, im 32-Bit-Modus ausgeführt.
• Xbox bezeichnet die Microsoft Xbox 360-Plattform.
• ARM kompiliert die Assembly so, dass sie auf einem Computer ausgeführt wird, der über einen Advanced RISC Machine (ARM)-Prozessor verfügt.
• ARM64 kompiliert die Assembly so, dass sie auf dem 64-Bit-CLR auf einem Computer ausgeführt wird, der über einen Advanced RISC Machine (ARM)-Prozessor verfügt, der den A64-Anweisungssatz unterstützt.

Eine Zielplattform ist die spezielle Plattform, auf der Ihr Projekt ausgeführt werden kann. Die Zielplattform wird in der PlatformTarget Buildeigenschaft in einer Projektdatei angegeben. Sie können die Zielplattform ändern, indem Sie die Projekteigenschaftenseiten oder den Configuration Manager in der IDE verwenden.

<PropertyGroup>
   <PlatformTarget>x86</PlatformTarget>
</PropertyGroup>

Der PlatformTarget Wert wird an den Compiler übergeben, um zu bestimmen, welche Ausgabe generiert werden soll. Bei C#-Projekten wird sie der C#-Compileroption -platformzugeordnet. Die Plattformoptionen werden unter Compileroptionen ausführlicher erläutert : PlatformTarget.

Eine Zielkonfiguration ist eine Teilmenge einer Zielplattform. Die Konfiguration enthält beispielsweise nicht die x86Debug meisten Codeoptimierungen. Die Zielkonfiguration wird in der Configuration Buildeigenschaft in einer Projektdatei angegeben. Sie können die Zielkonfiguration mithilfe der Projekteigenschaftenseiten oder des Configuration Managers ändern.

<PropertyGroup>
   <PlatformTarget>x86</PlatformTarget>
   <Configuration>Debug</Configuration>
</PropertyGroup>

Verwandte Inhalte

• Festlegen von Zielversionen