Mise à niveau et migration de solutions Office
Si vous disposez d'un projet Microsoft Office créé dans une version antérieure de Visual Studio, vous devez effectuer une mise à niveau du projet afin de l'utiliser dans Visual Studio 2010. Pour mettre à niveau un projet Microsoft Office, ouvrez-le dans une version de Visual Studio 2010 qui inclut les outils de développement Microsoft Office. Pour plus d'informations sur le processus de mise à niveau, consultez Comment : mettre à niveau des solutions Office. Pour plus d'informations sur les versions de Visual Studio 2010 qui incluent les outils de développement Microsoft Office, consultez Configuration d'un ordinateur pour développer des solutions Office.
Lorsque vous effectuez une mise à niveau d'un projet Microsoft Office, Visual Studio apporte plusieurs modifications au projet. Certaines modifications dépendent de la version du .NET Framework et de Microsoft Office que vous avez installée sur l'ordinateur de développement, et si le projet est un projet au niveau du document ou un projet au niveau de l'application.
Vous pouvez également modifier à tout moment la version cible du .NET Framework des projets Office en passant de .NET Framework 3.5 à .NET Framework 4, ou inversement. Pour plus d'informations, consultez Comment : cibler une version ou un profil spécifique du .NET Framework. Si vous modifiez la version cible du .NET Framework, certaines étapes supplémentaires peuvent être nécessaires pour exécuter la solution reciblée sur les ordinateurs de développement et les ordinateurs des utilisateurs finaux ; en outre votre projet ne pourra plus être compilé s'il utilise certaines fonctionnalités. Pour plus d'informations, consultez Migration de solutions Office vers .NET Framework 4.
Notes
Visual Studio 2010 ne peut pas effectuer la mise à niveau des projets de modèle de formulaire InfoPath créés à l'aide de versions antérieures de Visual Studio. Ces types de projets ne sont pas pris en charge dans Visual Studio 2010.
Versions de mise à niveau du projet prises en charge
Vous pouvez effectuer la mise à niveau des projets Office créés à l'aide de l'une des versions suivantes de Visual Studio Tools pour Office :
Microsoft Visual Studio 2005 Tools pour Microsoft Office System.
Microsoft Visual Studio 2005 Tools pour la version 2007 de Microsoft Office System (VSTO 2005 SE).
Microsoft Visual Studio Tools pour Microsoft Office System (version 3.0). Cette version de Visual Studio Tools pour Office figurait dans Visual Studio 2008.
Visual Studio 2010 ne prend pas en charge la mise à niveau des projets Microsoft Office créés à l'aide de Visual Studio Tools pour Office, version 2003. Pour continuer à développer l'un de ces projets dans Visual Studio 2010, créez un nouveau projet Office et portez manuellement votre code dans ce nouveau projet.
Notes
Visual Studio Tools pour Office était le nom des outils de développement Microsoft Office dans les versions antérieures de Visual Studio.
Modifications apportées aux projets mis à niveau
Lorsque vous effectuez une mise à niveau d'un projet Microsoft Office, Visual Studio apporte les modifications suivantes au projet :
Met à jour la version de Visual Studio Tools pour Office Runtime que le projet cible vers Visual Studio 2010 Tools pour Office Runtime.
Pour plus d'informations sur le runtime de Visual Studio Tools pour Office, consultez Vue d'ensemble de Visual Studio Tools pour Office Runtime.
Met à jour la version du .NET Framework que le projet cible, le cas échéant.
Met à jour les références d'assembly dans le projet.
Modifie le projet pour cibler la version de Microsoft Office que vous avez installée sur l'ordinateur de développement (Microsoft Office 2010 ou la version 2007 de Microsoft Office System) si le projet d'origine ciblait une version antérieure de Microsoft Office. Si aucune version de Microsoft Office n'est installée, le projet mis à niveau cible la version 2007 de Microsoft Office System.
.NET Framework ciblé
Lorsque vous mettez à niveau un projet Visual Studio Tools pour Office dans Visual Studio 2010, Visual Studio modifie le .NET Framework cible dans les cas suivants :
Le projet d'origine cible .NET Framework 2.0. Dans ce cas, Visual Studio modifie le projet de façon à cibler .NET Framework 3.5 si à la fois .NET Framework 3.5 et .NET Framework 4 sont installés sur l'ordinateur de développement. Si seul .NET Framework 4 est installé, Visual Studio modifie le projet pour cibler .NET Framework 4.
Le projet cible .NET Framework 3.5, mais seul .NET Framework 4 est installé sur l'ordinateur de développement. Dans ce cas, Visual Studio modifie le projet pour cibler .NET Framework 4.
Si le projet cible déjà .NET Framework 3.5, Visual Studio ne mettra pas à jour la version cible du .NET Framework dans le projet mis à niveau si .NET Framework 3.5 est également installé sur l'ordinateur de développement.
Notes
Si Visual Studio modifie la version cible du .NET Framework en .NET Framework 4, certaines étapes supplémentaires peuvent être nécessaires pour exécuter la solution reciblée sur les ordinateurs de développement et les ordinateurs des utilisateurs finaux ; en outre votre projet ne pourra plus être compilé s'il utilise certaines fonctionnalités. Pour plus d'informations, consultez Migration de solutions Office vers .NET Framework 4.
Le tableau suivant résume les modifications apportées à la version cible du .NET Framework pour les projets mis à niveau.
Version cible du .NET Framework du projet d'origine |
Versions du .NET Framework sur l'ordinateur de développement |
Version cible du .NET Framework du projet mis à niveau |
|---|---|---|
.NET Framework 2.0 .NET Framework 3.5 |
.NET Framework 3.5 et .NET Framework 4 |
.NET Framework 3.5 .gif "Remarque") Remarque
Si le projet d'origine cible .NET Framework 3.5 Client Profile, le projet mis à niveau cible .NET Framework 3.5.
|
.NET Framework 2.0 .NET Framework 3.5 |
.NET Framework 4 |
.NET Framework 4 Remarque
Si le projet d'origine cible .NET Framework 3.5 Client Profile, le projet mis à niveau cible .NET Framework 4 Client Profile.
|
Lorsque vous ciblez .NET Framework 4 dans un projet Office, vous pouvez utiliser certaines fonctionnalités qui ne sont pas disponibles lorsque vous ciblez .NET Framework 3.5. Pour plus d'informations, consultez Conception et création de solutions Office.
Références d'assembly
Visual Studio met à niveau les références d'assembly suivantes dans le projet :
Assemblys PIA (Primary Interop Assembly) Microsoft Office.
Assemblys dans Visual Studio Tools pour Office Runtime. Pour plus d'informations sur ces assemblys, consultez Vue d'ensemble de Visual Studio Tools pour Office Runtime.
Nouvelles versions ou versions mises à jour d'assemblys dépendants.
Visual Studio n'ajoute pas de références aux nouvelles versions ou aux versions mises à jour des assemblys que vous avez ajoutés au projet d'origine après sa création. Par exemple, si vous mettez à niveau un projet de complément Word 2003 qui référence également l'assembly PIA (Primary Interop Assembly) PowerPoint 2003, Visual Studio modifie le projet mis à niveau pour référencer l'assembly PIA Word 2007 ou Word 2010. Toutefois, vous devez mettre manuellement à jour la référence à l'assembly PIA PowerPoint.
Mise à niveau de projets Microsoft Office 2003
Par défaut, si Microsoft Office 2010 ou la version 2007 de Microsoft Office System est installée sur votre ordinateur de développement lorsque vous mettez à niveau un projet qui cible Microsoft Office 2003, Visual Studio modifie le projet pour cibler la version de Microsoft Office que vous avez installée. La case à cocher Toujours mettre à niveau vers la version d'Office installée de la page d'options Mise à niveau du projet permet de contrôler ce comportement. Si vous désactivez cette case à cocher, Visual Studio ne modifiera pas le projet de façon à cibler Microsoft Office 2010 ou la version 2007 de Microsoft Office System, et vous ne serez pas en mesure de développer, déboguer ni exécuter le projet. Pour plus d'informations sur cette option, consultez Mise à niveau du projet, boîte de dialogue Options.
D'autres éléments sont à prendre en compte pour la mise à niveau des personnalisations de niveau document et des compléments de niveau application ciblant Microsoft Office 2003.
Projets au niveau du document
Pour mettre à niveau un projet au niveau du document pour Microsoft Office 2003, la version appropriée de Microsoft Office 2010 ou la version 2007 de Microsoft Office System doit être installée sur l'ordinateur de développement. Par exemple, vous devez installer Word 2007 ou Word 2010 sur l'ordinateur avant de pouvoir mettre à niveau un projet Word 2003.
Lorsque vous effectuez une mise à niveau d'un projet au niveau du document avec un document enregistré dans un format binaire, vous devez décider s'il faut convertir le document en un format Open XML, ou conserver le document dans un format binaire. Vous devez sélectionner Open XML à moins que vous n'ayez une raison spécifique pour utiliser le format le plus ancien. Pour plus d'informations sur Open XML, consultez Introduction aux nouvelles extensions de noms de fichiers et formats Open XML (page éventuellement en anglais).
Si le document du projet contient des contrôles Windows Forms, Visual Studio 2005 Tools pour Office Second Edition Runtime doit être installé avant la mise à niveau du projet. Si cette version du runtime n'est pas installée sur l'ordinateur de développement avant la mise à niveau du projet, des erreurs de compilation ou d'exécution peuvent se produire dans le projet mis à niveau. Une fois la mise à niveau du projet terminée, vous pourrez désinstaller Visual Studio 2005 Tools pour Office Second Edition Runtime de l'ordinateur de développement s'il n'est pas utilisé par d'autres solutions Office. Cette version du runtime est disponible sous forme de package redistribuable depuis le Centre de téléchargement Microsoft : Microsoft Visual Studio 2005 Tools pour Office Second Edition Runtime (VSTO 2005 SE) (x86).
Projets au niveau de l'application
Si le fichier solution pour votre projet d'origine incluait un projet d'installation configuré pour installer le complément d'application, Visual Studio effectue la mise à niveau du projet d'installation vers un projet Visual Studio 2010, mais il n'apporte aucune autre modification au projet. Si vous souhaitez continuer à utiliser un fichier Windows Installer pour déployer votre complément, vous devez modifier le projet d'installation pour installer les nouveaux composants requis tels que .NET Framework 4 ou .NET Framework 3.5, Visual Studio 2010 Tools pour Office Runtime et éventuellement les assemblys PIA (Primary Interop Assembly) référencés par votre complément. Pour plus d'informations, consultez Déploiement d'une solution Office à l'aide de Windows Installer.
Si vous souhaitez utiliser ClickOnce pour déployer votre complément, vous pouvez supprimer intégralement le projet d'installation. Pour plus d'informations sur le déploiement de compléments à l'aide de ClickOnce, consultez Déploiement de solutions Office.
Voir aussi
Tâches
Comment : mettre à niveau des solutions Office
Référence
Mise à niveau du projet, boîte de dialogue Options