BuildManager.TargetFramework Eigenschaft

Definition

Ruft die Zielversion von .NET Framework für die aktuelle Website ab.

public:
 static property System::Runtime::Versioning::FrameworkName ^ TargetFramework { System::Runtime::Versioning::FrameworkName ^ get(); };
public static System.Runtime.Versioning.FrameworkName TargetFramework { get; }
static member TargetFramework : System.Runtime.Versioning.FrameworkName
Public Shared ReadOnly Property TargetFramework As FrameworkName

Eigenschaftswert

Die Zielversion von .NET Framework für die aktuelle Website.

Hinweise

Diese Eigenschaft unterstützt das feature ASP.NET multi-targeting, mit dem Sie die neueste Version von Visual Studio verwenden können, um Anwendungen zu entwickeln, die mit früheren Versionen von .NET Framework ausgeführt werden. Ein Buildanbieter kann diese Eigenschaft verwenden, um sicherzustellen, dass der Anbieter Code generiert, der für die Zielversion von .NET Framework geeignet ist. Beispielsweise können Sie unterschiedliche Code generieren, je nachdem, ob eine Website auf .NET Framework 3.5 oder .NET Framework 4 ausgerichtet ist. Weitere Informationen zu Multi-Targeting finden Sie unter .NET Framework Multi-Targeting for ASP.NET Web Projects.

Wenn die Website über keine Web.config-Datei verfügt, geht ASP.NET davon aus, dass die Zielframeworkversion die Version ist, die dem IIS-Anwendungspool zugeordnet ist, unter dem die Website ausgeführt wird. Für eine Dateisystemwebsite, die in Visual Studio ausgeführt wird, ist die Standardframeworkversion die aktuelle Version von .NET Framework.

Wenn die Website über eine Web.config-Datei verfügt, bestimmt ASP.NET das Zielframework, indem die Web.config-Datei untersucht wird.

Websites, die auf .NET Framework 2.0 ausgerichtet sind

Webanwendungen, die auf .NET Framework 2.0 abzielen, werden so kompiliert, als wäre das Ziel .NET Framework 3.0. Der Buildprozess unterscheidet nicht zwischen .NET Framework 2.0 und .NET Framework 3.0, da die Web.config-Datei weder die Compilerversion noch das Zielframework angibt, wenn eine dieser Versionen als Ziel verwendet wird. (Für .NET Framework 3.5 gibt die Web.config-Datei die Compilerversion an, und für .NET Framework 4 gibt die Web.config-Datei das Zielframework an.) Daher gibt diese Eigenschaft für Webanwendungen, die auf .NET Framework 2.0 abzielen, einen Zielframeworkmoniker zurück, der .NET Framework 3.0 angibt.

Dies verursacht normalerweise keine Probleme. Visual Studio verhindert, dass Sie Verweise auf .NET Framework 3.0-Features in einem Projekt erstellen, das für .NET Framework 2.0 vorgesehen ist. Visual Studio stellt beispielsweise keine Elementvorlagen für WCF-Dienste in einem Projekt bereit, das für .NET Framework 2.0 vorgesehen ist, da WCF mit .NET Framework 3.0 eingeführt wurde und nicht mit .NET Framework 2.0 kompatibel ist.

Wenn Sie eine Website in einer .NET Framework 2.0-Laufzeitumgebung bereitstellen möchten und sie ein anderes Tool als Visual Studio verwenden, um auf Features zu verweisen, die nur mit .NET Framework 3.0 kompatibel sind, kann das Projekt ohne Fehler oder Warnungen erstellt werden. Die Anwendung kann jedoch Fehler generieren, wenn die Website unter .NET Framework 2.0 ausgeführt wird.

Gilt für: