BuildManager.TargetFramework Propriété

Définition

Espace de noms:

System.Web.Compilation

Assembly:

System.Web.dll

Obtient la version cible du .NET Framework pour le site Web actuel.

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

Valeur de propriété

FrameworkName

Version cible du .NET Framework pour le site Web actuel.

Remarques

Cette propriété prend en charge la fonctionnalité multi-ciblage ASP.NET, qui vous permet d’utiliser la dernière version de Visual Studio pour développer des applications qui s’exécuteront avec des versions antérieures du .NET Framework. Un fournisseur de build peut utiliser cette propriété pour s’assurer qu’il génère du code approprié pour la version ciblée du .NET Framework. Par exemple, vous pouvez générer un code différent selon qu’un site Web cible .NET Framework 3.5 ou .NET Framework 4. Pour plus d’informations sur le multi-ciblage, consultez Multi-ciblage .NET Framework pour les projets web ASP.NET.

Si le site Web n’a pas de fichier Web.config, ASP.NET suppose que la version du framework cible est la version associée au pool d’applications IIS sous lequel le site s’exécute. Pour un site Web de système de fichiers qui s’exécute dans Visual Studio, la version par défaut de l’infrastructure est la version actuelle du .NET Framework.

Si le site Web a un fichier Web.config, ASP.NET détermine l’infrastructure cible en examinant le fichier Web.config.

Sites web qui ciblent .NET Framework 2.0

Les applications web qui ciblent le .NET Framework 2.0 sont compilées comme si la cible était .NET Framework 3.0. Le processus de génération ne fait pas la différence entre .NET Framework 2.0 et .NET Framework 3.0, car le fichier Web.config n’indique pas la version du compilateur ou l’infrastructure cible quand l’une de ces versions est ciblée. (Pour le .NET Framework 3.5, le fichier Web.config spécifie la version du compilateur, et pour .NET Framework 4, le fichier Web.config spécifie l’infrastructure cible.) Par conséquent, pour les applications web qui ciblent le .NET Framework 2.0, cette propriété retourne un moniker d’infrastructure cible qui indique le .NET Framework 3.0.

Cela ne provoque normalement aucun problème. Visual Studio vous empêche de créer des références aux fonctionnalités de .NET Framework 3.0 dans un projet qui est ciblé pour .NET Framework 2.0. Par exemple, Visual Studio ne fournit pas de modèles d’élément pour les services WCF dans un projet destiné à .NET Framework 2.0, car WCF a été introduit avec .NET Framework 3.0 et n’est pas compatible avec .NET Framework 2.0.

Si vous envisagez de déployer un site Web dans un environnement d’exécution .NET Framework 2.0 et que vous utilisez un outil autre que Visual Studio pour référencer des fonctionnalités compatibles uniquement avec .NET Framework 3.0, le projet peut être généré sans générer d’erreurs ou d’avertissements. Toutefois, l’application peut générer des erreurs lorsque le site Web s’exécute sur .NET Framework 2.0.