Modifications du design de projets Office qui ciblent .NET Framework 4

Visual Studio 2010 contient des modifications en matière de conception des projets Office ciblant le .NET Framework 4. Si vous êtes familiarisé avec les projets Office des versions antérieures de Visual Studio, vous devez être informé de ces modifications avant de développer des projets Office ciblant le .NET Framework 4. Si vous souhaitez mettre à jour un projet existant pour qu'il cible .NET Framework 4, vous devez être informé de certains changements majeurs.

Comprendre le design basé sur l'interface de Visual Studio 2010 Tools pour Office Runtime

Lorsque vous développez un projet Office qui cible le .NET Framework 4, 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, les types Worksheet et 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 :

• Mise à jour de projets Excel et Word qui font l'objet d'une migration vers .NET Framework 4

• Mise à jour des personnalisations de ruban dans les projets Office qui font l'objet d'une migration vers .NET Framework 4

• Mise à jour de zones de formulaire dans les projets Outlook qui font l'objet d'une migration vers .NET Framework 4

Nouvelles classes de base dans les projets Office

Le nouveau design basé sur l'interface de Visual Studio 2010 Tools pour Office Runtime affecte les classes générées dans les projets Office, tels que ThisDocument, ThisWorkbooket 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 le .NET Framework 4, ces classes Visual Studio Tools pour Office Runtime sont désormais 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 2010. 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 principales nouveautés que vous pouvez rencontrer dans les projets Office reciblés vers .NET Framework 4. Pour plus d'informations, consultez Migration de solutions Office vers .NET Framework 4.

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.
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 de projets Excel et Word qui font l'objet d'une migration vers .NET Framework 4.
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 de ruban de votre projet. Vous devez modifier tout code qui instancie des contrôles du ruban pendant l'exécution, gère des événements du ruban ou définit par programmation la position d'un composant de ruban. 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.
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.
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. Pour plus d'informations, consultez Vue d'ensemble des balises actives.	Vous devez modifier tout code qui crée des objets de balise active et d'action et tout code qui définit un module de reconnaissance de balise active personnalisé. Pour plus d'informations, consultez Mise à jour de projets Excel et Word qui font l'objet d'une migration vers .NET Framework 4.
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 de projets Excel et Word qui font l'objet d'une migration vers .NET Framework 4.
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 de projets Excel et Word qui font l'objet d'une migration vers .NET Framework 4.
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 de projets Excel et Word qui font l'objet d'une migration vers .NET Framework 4.
Les classes d'éléments hôtes (telles que ThisWorkbook, Sheetn, ThisDocument et ThisAddIn) ne fournissent plus de méthode Dispose que vous pouvez substituer.	Vous devez déplacer tout code de la substitution de méthode Dispose vers le gestionnaire d'événements Shutdown de la classe d'élément hôte (par exemple, ThisAddIn_Shutdown) et supprimer la substitution de méthode Dispose de votre classe d'élément hôte.

Voir aussi

Concepts

Migration de solutions Office vers .NET Framework 4

Nouveautés du développement Office

Vue d'ensemble de Visual Studio Tools pour Office Runtime

Historique des modifications

Date	Historique	Motif
Mai 2010	Ajout d'informations sur la suppression de la méthode Dispose dans les projets ciblant .NET Framework 4.	Améliorations apportées aux informations.