Modifications du design de projets Office qui ciblent .NET Framework 4 ou .NET Framework 4.5
À partir de Visual Studio 2010, Visual Studio a introduit des modifications à la conception des projets Office qui ciblent .NET Framework 4 ou .NET Framework 4.5.Si vous êtes familiarisé avec les projets Office dans les versions antérieures de Visual Studio, vous devez tenir compte de ces modifications avant de élaboriez les projets Office qui ciblent les versions du .NET Framework.Par défaut, tous les projets que vous créez à l'aide de la cible d' Visual Studio 2012 ces versions.
Les sections suivantes décrivent ces modifications de conception de projet Office.
Comprendre le design basé sur l'interface de Visual Studio 2010 Tools pour Office Runtime
Lorsque vous développez un projet Office qui cible .NET Framework 4 ou .NET Framework 4.5, la plupart des types que vous utilisez dans Visual Studio 2010 tools pour Office Runtime sont des interfaces.Il s'agit d'un changement majeur par rapport aux versions antérieures de Visual Studio Tools pour Office Runtime, dans lesquelles ces types sont des classes.Par exemple, lorsque vous ciblez .NET Framework 4 ou .NET Framework 4.5, les types d' Worksheet et d' Document sont des interfaces et non des classes.Pour plus d'informations, consultez Vue d'ensemble de Visual Studio Tools pour Office Runtime.
Pour tous les types que vous pouviez instancier directement dans les versions antérieures de Visual Studio Tools pour Office Runtime, vous devez maintenant utiliser des méthodes de l'objet Globals.Factory pour obtenir des instances de ces types.Par exemple, pour obtenir un objet qui implémente l'interface SmartTag, utilisez la méthode Globals.Factory.CreateSmartTag.Pour plus d'informations, consultez les rubriques suivantes :
.gif "Ee712588.collapse_all(fr-fr,VS.110).gif")
Nouvelles classes de base dans les projets Office
La nouvelle design basé sur Visual Studio 2010 tools pour Office Runtime affecte les classes générées dans les projets Office, tels qu' ThisDocument, ThisWorkbook, et ThisAddIn.Dans les projets Office qui ciblent le .NET Framework 3.5 et versions antérieures, ces classes générées dérivent de classes de Visual Studio Tools pour Office Runtime telles que Microsoft.Office.Tools.Word.Document, Microsoft.Office.Tools.Excel.Worksheet et Microsoft.Office.Tools.AddIn.Dans les projets qui ciblent .NET Framework 4 ou .NET Framework 4.5, ces classes d' Visual Studio Tools pour Office Runtime sont maintenant des interfaces.Par conséquent, les classes générées dans les projets Office ne peuvent plus en dériver leur implémentation.Les classes générées dérivent des nouvelles classes de base telles que DocumentBase, WorksheetBase et AddInBase.Pour plus d'informations, consultez Programmation de compléments d'application et Programmation de personnalisations au niveau du document.
Les classes de base ne font pas partie du Visual Studio Tools pour Office Runtime redistribuable.Elles sont définies dans les assemblys d'utilitaires inclus dans Visual Studio 2012.Ces assemblys sont copiés dans le dossier de sortie lorsque vous générez des projets Office et doivent être déployés avec votre solution.Pour plus d'informations sur les assemblys d'utilitaires, consultez Assemblys dans Visual Studio Tools pour Office Runtime.
Nouveautés dans les projets Office reciblés vers .NET Framework 4
Le tableau suivant répertorie les nouveautés principales que vous pouvez rencontrer dans les projets Office reciblés vers .NET Framework 4 ou à .NET Framework 4.5.Pour plus d'informations, consultez Migration de solutions Office vers .NET Framework 4 ou .NET Framework 4.5.
Nouveauté |
Conséquence |
|---|---|
SecurityTransparentAttribute n'est plus utilisé ni pris en charge dans les projets Office. |
Vous devez supprimer cet attribut du fichier de code AssemblyInfo dans les projets Office que vous mettez à niveau depuis Visual Studio 2008.Pour plus d'informations, consultez Modifications requises pour exécuter des projets Office qui font l'objet d'une migration vers .NET Framework 4 ou .NET Framework 4.5. |
ExcelLocale1033Attribute n'est plus utilisé ni pris en charge dans les projets Excel. |
Vous devez supprimer cet attribut du fichier de code AssemblyInfo dans les projets Excel.Pour plus d'informations, consultez Mise à jour des projets Excel et Word qui font l'objet d'une migration vers .NET Framework 4 ou .NET Framework 4.5. |
Le modèle de programmation des éléments de projet Ruban (Concepteur visuel) a changé. |
Vous devez modifier le fichier code-behind pour tous les éléments du ruban dans votre projet.Vous devez également modifier tout code qui instancie des contrôles du ruban pendant l'exécution, gère des événements du ruban, ou définit la position d'un composant de ruban par programme.Pour plus d'informations, consultez Mise à jour des personnalisations de ruban dans les projets Office qui font l'objet d'une migration vers .NET Framework 4 ou .NET Framework 4.5. |
Le modèle de programmation des zones de formulaire Outlook a changé. |
Vous devez modifier le fichier code-behind pour toutes les zones de formulaire de votre projet et tout code qui instancie certaines classes de zone de formulaire au moment de l'exécution.Pour plus d'informations, consultez Mise à jour de zones de formulaire dans les projets Outlook qui font l'objet d'une migration vers .NET Framework 4 ou .NET Framework 4.5. |
Le modèle de programmation des balises actives des projets Excel et Word ont changé.Les balises actives sont déconseillées dans Excel 2010 et Word 2010. |
Si votre solution utilise des balises actives, des erreurs se produisent lorsque vous générez le projet.Étant donné que les balises actives sont déconseillées dans Excel 2010 et Word 2010, vous devez supprimer les balises avant de pouvoir tester et déboguer la solution dans Visual Studio 2012. |
La syntaxe des méthodes GetVstoObject et HasVstoObject a changé. |
Vous devez passer l'objet Globals.Factory à ces méthodes lorsque vous y accédez sur les objets natifs depuis les assemblys PIA. Vous pouvez également accéder à ces méthodes sur l'objet retourné par la propriété Globals.Factory dans votre projet.Pour plus d'informations, consultez Mise à jour des projets Excel et Word qui font l'objet d'une migration vers .NET Framework 4 ou .NET Framework 4.5. |
Les événements de contrôles de contenu Word sont associés aux nouveaux délégués. |
Vous devez modifier tout code qui gère des événements de contrôles de contenu Word pour spécifier les nouveaux délégués.Pour plus d'informations, consultez Mise à jour des projets Excel et Word qui font l'objet d'une migration vers .NET Framework 4 ou .NET Framework 4.5. |
Les classes OLEObject et OLEControl ont été renommées. |
Vous devez modifier tout code qui utilise des instances de ces classes et utiliser à la place des objets Microsoft.Office.Tools.Excel.ControlSite ou Microsoft.Office.Tools.Word.ControlSite.Pour plus d'informations, consultez Mise à jour des projets Excel et Word qui font l'objet d'une migration vers .NET Framework 4 ou .NET Framework 4.5. |
Les classes d'élément hôte, tel qu' ThisWorkbook, Sheetn, ThisDocument, et ThisAddIn, ne fournissent une méthode d' Dispose que vous pouvez substituer. |
Vous devez déplacer tout code dans la substitution de méthode d' Dispose au gestionnaire d'événements d' Shutdown dans la classe d'élément hôte, par exemple, ThisAddIn_Shutdown, et supprimez la substitution de méthode d' Dispose de votre classe d'élément hôte. |
Voir aussi
Concepts
Migration de solutions Office vers .NET Framework 4 ou .NET Framework 4.5
Vue d'ensemble de Visual Studio Tools pour Office Runtime