comment : modifier la version cible de .Net Framework et l'ensemble d'outils de la plateforme

Article
10/12/2023

Vous pouvez modifier un fichier projet Visual Studio C++ pour cibler différentes versions de l’ensemble d’outils de plateforme C++. Le Kit de développement logiciel (SDK) Windows et le .NET Framework utilisés sont également modifiables. (.NET Framework s’applique uniquement aux projets C++/CLI). Un nouveau projet utilise le .NET Framework et l’ensemble d’outils par défaut de la version de Visual Studio que vous utilisez pour créer le projet. Si vous modifiez ces valeurs dans le fichier .vcxproj, vous pouvez utiliser la même base de code pour chaque cible de compilation.

Ensemble d’outils de plateforme

L’ensemble d’outils de plateforme se compose du compilateur C++ (cl.exe) et de l’éditeur de liens (link.exe), ainsi que des bibliothèques standard C/C++. Visual Studio 2015, Visual Studio 2017 et Visual Studio 2019 sont compatibles binaires. Il est montré par la version principale de l’ensemble d’outils, qui est resté à 14. Les projets compilés dans Visual Studio 2019 ou Visual Studio 2017 sont compatibles avec ABI avec les projets 2017 et 2015. La version mineure a été mise à jour de 1 pour chaque version depuis Visual Studio 2015 :

Visual Studio 2015 : v140
Visual Studio 2017 : v141
Visual Studio 2019 : v142
Visual Studio 2022 : v143

Ces ensembles d’outils prennent en charge .NET Framework 4.5 et versions ultérieures.

Visual Studio prend également en charge le multi-ciblage pour les projets C++. Vous pouvez utiliser l’IDE Visual Studio le plus récent pour modifier et générer des projets créés par des versions antérieures de Visual Studio. Il ne nécessite pas de mise à niveau d’un projet pour utiliser une nouvelle version de l’ensemble d’outils. Il nécessite que l’ensemble d’outils plus ancien soit installé sur votre ordinateur. Pour plus d’informations, consultez Comment utiliser le multi-ciblage natif dans Visual Studio. Par exemple, dans Visual Studio 2015, vous pouvez cibler .NET Framework 2.0, mais vous devez utiliser un ensemble d’outils antérieur qui le prend en charge.

Framework cible (projet C++/CLI uniquement)

Lorsque vous changez le Framework cible, remplacez également l'ensemble d'outils de plateforme par une version qui prend en charge ce Framework. Par exemple, pour cibler .NET Framework 4.5, vous devez utiliser un ensemble d’outils de plateforme compatible. Ces ensembles d’outils incluent Visual Studio 2015 (v140), Visual Studio 2013 (v120) ou Visual Studio 2012 (v110). Vous pouvez utiliser le SDK Windows 7.1 pour cibler .NET Framework 2.0, 3.0, 3.5 et 4.

Vous pouvez étendre davantage la plateforme cible en créant un ensemble d'outils de plateforme personnalisé. Pour plus d’informations, consultez Multiciblage natif C++ sur le blog de Visual C++.

Pour changer la version cible du .Net Framework

Dans Visual Studio, dans l’ Explorateur de solutions, sélectionnez votre projet. Sur la barre de menus, ouvrez le menu Projet et choisissez Décharger le projet. Cette commande décharge le fichier de projet (.vcxproj) pour votre projet.

Remarque

Un projet C++ ne peut pas être chargé pendant que vous modifiez le fichier projet dans Visual Studio. Toutefois, vous pouvez utiliser un autre éditeur tel que le Bloc-notes pour modifier le fichier projet lorsque le projet est chargé dans Visual Studio. Visual Studio détecte que le fichier projet a changé et vous invite à recharger le projet.
Dans la barre de menus, sélectionnez Fichier, Ouvrir, Fichier. Dans la boîte de dialogue Ouvrir un fichier , accédez à votre dossier de projet, puis ouvrez le fichier projet (.vcxproj).
Dans le fichier projet, recherchez l'entrée correspondant à la version du Framework cible. Par exemple, si votre projet est destiné à utiliser .NET Framework 4.5, recherchez <TargetFrameworkVersion>v4.5</TargetFrameworkVersion> dans l'élément <PropertyGroup Label="Globals"> de l'élément <Project> . Si l'élément <TargetFrameworkVersion> n'est pas présent, votre projet n'utilise pas le .NET Framework et aucune modification n'est requise.
Remplacez la valeur par la version du .NET Framework de votre choix, comme v3.5 ou v4.
Enregistrez les modifications et fermez l'éditeur.
Dans l' Explorateur de solutions, ouvrez le menu contextuel de votre projet et choisissez Recharger le projet.
Pour vérifier la modification, dans la barre de menus, sélectionnez >Propriétés du projet pour ouvrir la boîte de dialogue Pages de propriétés de votre projet. Dans la boîte de dialogue, sélectionnez la page de propriétés générales des propriétés>de configuration. Vérifiez que Version du .NET Framework cible indique la nouvelle version du .NET Framework.

Pour modifier l’ensemble d’outils de plateforme

Dans Visual Studio, dans la barre de menus, sélectionnez> Propriétés du projet pour ouvrir la boîte de dialogue Pages de propriétés de votre projet.
En haut de la boîte de dialogue Pages de propriétés, ouvrez la liste déroulante Configuration , puis sélectionnez Toutes les configurations.
Dans la boîte de dialogue, sélectionnez la page de propriétés générales des propriétés>de configuration.
Dans la page des propriétés, sélectionnez Ensemble d’outils de plateforme, puis sélectionnez l’ensemble d’outils souhaité dans la liste déroulante. Par exemple, si vous avez installé l’ensemble d’outils Visual Studio 2010, sélectionnez Visual Studio 2010 (v100) pour l’utiliser pour votre projet.
Choisissez le bouton OK pour enregistrer vos modifications.

Étapes suivantes

Procédure pas à pas : utilisation de projets et de solutions (C++)

Voir aussi

MSBuild sur la ligne de commande – C++