MSBuild-Zielframework und -ZielplattformMSBuild target framework and target platform

Ein Projekt kann erstellt werden, um in einem Zielframework, bei dem es sich um eine bestimmte Version von .NET Framework handelt, und auf einer Zielplattform, bei der es sich um eine bestimmte Softwarearchitektur handelt, ausgeführt zu werden.A project can be built to run on a target framework, which is a particular version of the .NET Framework, and a target platform, which is a particular software architecture. Beispielsweise können Sie eine Anwendung für die Ausführung in .NET Framework 2.0 auf einer 32-Bit-Plattform entwickeln, die mit der 802x86-Prozessorfamilie kompatibel ist („x86“).For example, you can target an application to run on the .NET Framework 2.0 on a 32-bit platform that is compatible with the 802x86 processor family ("x86"). Die Kombination von Zielframework und Zielplattform wird als Zielkontext bezeichnet.The combination of target framework and target platform is known as the target context.

Wichtig

In diesem Artikel wird die alte Methode zum Angeben eines Zielframeworks beschrieben.This article shows the old way to specify a target framework. Projekte im SDK-Format ermöglichen unterschiedliche Zielframeworks wie .NET Standard.SDK-style projects enable different TargetFrameworks like netstandard. Weitere Informationen finden Sie unter Zielframeworks.For more info, see Target frameworks.

Zielframework und -profilTarget framework and profile

Ein Zielframework ist eine bestimmte Version von .NET Framework, mit der das Projekt ausgeführt werden soll.A target framework is the particular version of the .NET Framework that your project is built to run on. Die Angabe eines Zielframeworks ist erforderlich, da es Compilerfunktionen und Assemblyverweise ermöglicht, die nur für diese Version des Frameworks gelten.Specification of a target framework is required because it enables compiler features and assembly references that are exclusive to that version of the framework.

Derzeit werden die folgenden Versionen von .NET Framework unterstützt:Currently, the following versions of the .NET Framework are available for use:

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

  • .NET Framework 3.0 (enthalten in Windows Vista)The .NET Framework 3.0 (included in Windows Vista)

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

  • .NET Framework 4.5.2The .NET Framework 4.5.2

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

  • .NET Framework 4.6.1The .NET Framework 4.6.1

  • .NET Framework 4.6.2The .NET Framework 4.6.2

  • .NET Framework 4.7The .NET Framework 4.7

  • .NET Framework 4.7.1The .NET Framework 4.7.1

  • .NET Framework 4.7.2The .NET Framework 4.7.2

  • .NET Framework 4.8The .NET Framework 4.8

Die Versionen von .NET Framework unterscheiden sich in der Liste der Assemblys, die als Verweise zur Verfügung stehen.The versions of the .NET Framework differ from one another in the list of assemblies that each makes available to reference. Beispielsweise können Sie Windows Presentation Foundation (WPF)-Anwendungen nur erstellen, wenn Ihr Projekt auf die .NET Framework-Version 3.0 oder höher ausgelegt ist.For example, you cannot build Windows Presentation Foundation (WPF) applications unless your project targets the .NET Framework version 3.0 or above.

Das Zielframework wird in der TargetFrameworkVersion-Eigenschaft in einer Projektdatei angegeben.The target framework is specified in the TargetFrameworkVersion property in the project file. Sie können das Zielframework für ein Projekt ändern, indem Sie die Projekteigenschaftenseiten in der integrierten Entwicklungsumgebung (Integrated Development Environment, IDE) von Visual Studio verwenden.You can change the target framework for a project by using the project property pages in the Visual Studio integrated development environment (IDE). Weitere Informationen finden Sie unter Vorgehensweise: .NET Framework-Version als Ziel.For more information, see How to: Target a version of the .NET Framework. Die verfügbaren Werte für TargetFrameworkVersion sind v2.0, v3.0, v3.5, v4.5.2, v4.6, v4.6.1, v4.6.2, v4.7, v4.7.1, v4.7.2 und v4.8.The available values for TargetFrameworkVersion are v2.0, v3.0, v3.5, v4.5.2, v4.6, v4.6.1, v4.6.2, v4.7, v4.7.1, v4.7.2, and v4.8.

<TargetFrameworkVersion>v4.0</TargetFrameworkVersion>

Ein Zielprofil ist eine Teilmenge eines Zielframeworks.A target profile is a subset of a target framework. Beispielsweise enthält das .NET Framework 4-Clientprofil keine Verweise auf die MSBuild-Assemblys.For example, the .NET Framework 4 Client profile does not include references to the MSBuild assemblies.

Hinweis

Zielprofile gelten nur für portable Klassenbibliotheken.Target profiles apply only to portable class libraries.

Das Zielprofil wird in der TargetFrameworkProfile-Eigenschaft in einer Projektdatei angegeben.The target profile is specified in the TargetFrameworkProfile property in a project file. Sie können das Zielprofil ändern, indem Sie das Zielframeworksteuerelement in den Projekteigenschaftenseiten der IDE verwenden.You can change the target profile by using the target-framework control in the project property pages in the IDE.

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

ZielplattformTarget platform

Eine Plattform ist eine Kombination aus Hardware und Software, die eine bestimmte Laufzeitumgebung definiert.A platform is combination of hardware and software that defines a particular runtime environment. Ein auf ein Objekt angewendeterFor example,

  • x86 steht für ein 32-Bit-Windows-Betriebssystem, das auf einem Intel 80x86-Prozessor oder einem vergleichbaren Prozessor ausgeführt wird.x86 designates a 32-bit Windows operating system that is running on an Intel 80x86 processor or its equivalent.

  • x64 steht für ein 64-Bit-Windows-Betriebssystem, das auf einem Intel x64-Prozessor oder einem vergleichbaren Prozessor ausgeführt wird.x64 designates a 64-bit Windows operating system that is running on an Intel x64 processor or it equivalent.

  • Xbox steht für die Microsoft Xbox 360-Plattform.Xbox designates the Microsoft Xbox 360 platform.

Eine Zielplattform ist die spezielle Plattform, auf der Ihr Projekt ausgeführt werden kann.A target platform is the particular platform that your project is built to run on. Die Zielplattform wird in der PlatformTarget-Buildeigenschaft in einer Projektdatei angegeben.The target platform is specified in the PlatformTarget build property in a project file. Sie können die Zielplattform ändern, indem Sie die Projekteigenschaftenseiten oder den Konfigurations-Manager in der IDE verwenden.You can change the target platform by using the project property pages or the Configuration Manager in the IDE.

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

Eine Zielkonfiguration ist eine Teilmenge einer Zielplattform.A target configuration is a subset of a target platform. x86``Debug-Konfiguration enthält z.B. nicht die meisten Codeoptimierungen.For example, the x86``Debug configuration does not include most code optimizations. Die Zielkonfiguration wird in der Configuration-Buildeigenschaft in einer Projektdatei angegeben.The target configuration is specified in the Configuration build property in a project file. Sie können die Zielkonfiguration ändern, indem Sie die Projekteigenschaftenseiten oder den Konfigurations-Manager verwenden.You can change the target configuration by using the project property pages or the Configuration Manager.

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

Siehe auchSee also