Mise à niveau et migration de solutions Office

Article
04/28/2010

Mise à jour : novembre 2007

Utilisez l'Assistant Conversion de Visual Studio pour mettre à niveau des projets de Visual Studio Tools pour Office, version 2003 et Microsoft Visual Studio 2005 Tools pour Microsoft Office System vers Visual Studio Tools pour Office System 3.0. Pour mettre à niveau une solution Microsoft Office, ouvrez-la dans Visual Studio avec Visual Studio Tools pour Office System 3.0 installé. L'Assistant Conversion de Visual Studio s'affiche et vous guide à travers les étapes de la mise à niveau. Pour plus d'informations, consultez Comment : mettre à niveau des solutions Visual Studio Tools pour Office.

L'Assistant ne modifie pas votre code. Si vous mettez à niveau un projet de complément Outlook 2003, vous devrez peut-être mettre votre code à jour manuellement. Pour plus d'informations, consultez Projets Outlook.

Références d'assembly

L'Assistant Conversion de Visual Studio met à niveau le fichier projet et la référence à l'assembly PIA (Primary Interop Assembly) de l'application Microsoft Office principale pour la solution. De plus, il ajoute des références à des versions nouvelles ou mises à jour d'assemblys dépendants. Toutefois, l'Assistant n'ajoute pas de références à des versions nouvelles ou mises à jour des assemblys que vous ajoutez manuellement au projet après la création du projet initial.

Par exemple, si vous mettez à niveau un projet de complément Word 2003 qui comporte des références à un assembly de méthode d'assistance et à l'assembly PIA (Primary Interop Assembly) PowerPoint, l'Assistant Conversion de Visual Studio s'assure que les références à l'assembly PIA (Primary Interop Assembly) Word et à l'assembly d'assistance sont correctes. Toutefois, vous devez mettre à jour la référence à l'assembly PIA (Primary Interop Assembly) PowerPoint manuellement.

Mise à niveau de version

Par défaut, si la version 2007 de Microsoft Office System est installée, l'Assistant met à niveau les projets Microsoft Office 2003 en projets pour Microsoft Office 2007. Le processus est différent pour les personnalisations au niveau du document et les compléments d'application.

Projets de personnalisation au niveau du document

Si vous mettez à niveau une personnalisation au niveau du document, vous ne pouvez pas empêcher l'Assistant de mettre à niveau la version de projet. Cela tient au fait que le concepteur qui s'affiche lorsque vous ouvrez une personnalisation au niveau du document utilise la version actuellement installée d'Office. Le projet peut s'ouvrir dans le concepteur uniquement s'il correspond à la version d'Office installée.

Pour mettre à niveau un projet de personnalisation au niveau du document, vous devez disposer de l'application Office appropriée. Par exemple, vous devez disposer de Word 2003 ou Word 2007 pour pouvoir mettre à niveau un projet de personnalisation au niveau du document Word 2003.

Si vous disposez de la version 2007 de Microsoft Office System, l'Assistant Conversion de Visual Studio vous oblige à spécifier si vous souhaitez convertir le document à l'un des formats Open XML. Vous devez convertir le format du document, excepté si vous avez une raison spécifique d'utiliser le format plus ancien. Pour plus d'informations sur ces formats, consultez Présentation des nouvelles extensions de noms de fichiers et des formats Open XML (en anglais).

Si Microsoft Office 2003 est installé lorsque vous mettez à niveau le projet, ce dernier continuera à utiliser Microsoft Office 2003 comme version cible et le format du document restera inchangé.

Si vous mettez à niveau un projet au niveau du document créé avec Visual Studio Tools pour Office, version 2003, vous devez exécuter manuellement certaines étapes de mise à niveau. Pour plus d'informations, consultez Mise à niveau de Visual Studio Tools pour Office, version 2003.

Projets de complément d'application

Si la version 2007 de Microsoft Office System est installée et que vous ne souhaitez pas que l'Assistant Conversion de Visual Studio effectue une mise à niveau des projets de complément de la version 2003 vers la version 2007, vous pouvez modifier la valeur par défaut afin de conserver la version 2003 pour ces projets. Puisque la version 2007 d'Office peut héberger des compléments Office 2003, vous pouvez développer, compiler et tester le projet même si vous ne disposez pas de la version 2003. Désélectionnez l'option Toujours mettre à niveau vers la version d'Office installée. sur la page d'options Mise à niveau du projet. Pour plus d'informations, consultez Mise à niveau du projet, boîte de dialogue Options.

L'Assistant Conversion de Visual Studio ne peut pas rendre les projets de complément compatibles avec une version antérieure d'Office. Par conséquent, si vous disposez d'Office 2003 et que vous mettez à niveau un projet de complément 2007, le projet reste un projet de complément version 2007 après la mise à niveau. Vous pouvez ouvrir le projet, développer le complément et compiler le code. Toutefois, vous ne pouvez pas tester le complément car Office 2003 n'héberge pas les compléments version 2007.

Il n'est pas nécessaire de disposer de Microsoft Office pour mettre à niveau un projet de complément d'application.

Projets Outlook

Si vous mettez à niveau un projet de complément Outlook 2003, vous devez mettre à jour le nom de votre classe d'élément hôte et les références à l'objet Microsoft.Office.Interop.Outlook.Application.

Remarque :
Il n'est pas nécessaire de mettre à jour les projets créés avec des modèles de projet Microsoft Visual Studio 2005 Tools pour la version 2007 de Microsoft Office System (VSTO 2005 SE).

Nom de la classe d'élément hôte

L'Assistant Conversion de Visual Studio ne met pas à jour le nom de votre classe d'élément hôte. La classe conserve le nom ThisApplication. Il n'est pas nécessaire de la renommer. Toutefois, les exemples de code de la documentation d'aide de Visual Studio Tools pour Office System 3.0 utilisent le nom de classe d'élément hôte ThisAddIn. Si vous souhaitez simplifier le test du code en le copiant et en le collant dans votre propre projet, vous pouvez utiliser le nom ThisAddIn, puis refactoriser cette modification de nom dans l'ensemble du projet. Pour plus d'informations sur la refactorisation du code dans un projet C#, consultez Comment : renommer des identificateurs. Pour plus d'informations sur la refactorisation du code dans un projet Visual Basic, consultez Comment : renommer un identificateur.

Références à l'objet application

L'Assistant Conversion de Visual Studio ne modifie pas votre code. Par conséquent, vous devez modifier manuellement tout le code qui utilise l'une des techniques suivantes pour accéder à l'objet Microsoft.Office.Interop.Outlook.Application :

Mot clé this (en C#) ou Me (en Visual Basic) dans la classe ThisApplication.
Objet Globals.ThisApplication dans le code à l'extérieur de la classe ThisApplication.

Par exemple, si votre classe ThisApplication contient le code suivant, vous devez effectuer une mise à jour.

Me.ActiveExplorer()

this.ActiveExplorer();

Le code suivant fonctionne comme un code de remplacement dans les projets mis à niveau.

Me.Application.ActiveExplorer()

This.Application.ActiveExplorer();

La classe d'élément hôte ThisApplication des projets Microsoft Visual Studio 2005 Tools pour Microsoft Office System hérite directement de la classe Microsoft.Office.Tools.Outlook.Application. Cependant, la classe d'élément hôte ThisAddIn des projets Visual Studio Tools pour Office System 3.0 n'hérite pas de Microsoft.Office.Tools.Outlook.Application. À la place, vous référencez l'objet d'application actif à l'aide de la propriété Application de la classe d'élément hôte.

Mise à niveau vers la version 2007 de Microsoft Office

Si vous effectuez une mise à niveau vers la version 2007 de Microsoft Office après la mise à niveau d'un projet Visual Studio Tools pour Office, l'Assistant Conversion de Visual Studio s'affichera à la prochaine ouverture du projet.

Les projets de complément pour la version 2007 d'Office que vous avez choisi de ne pas mettre à niveau lorsque vous disposiez d'Office 2003 vont maintenant s'exécuter et vous pouvez les tester en appuyant sur F5 ou CTRL+F5 dans Visual Studio.

Voir aussi

Partager via