Partager via

Assemblies d’interopérabilité primaires Office

Pour utiliser les fonctionnalités d’une application Microsoft Office à partir d’un projet Office, vous devez utiliser l’assembly PIA (Primary Interop Assembly) pour l’application. Le PIA permet au code managé d’interagir avec un modèle objet basé sur COM d’une application Microsoft Office.

Note

Vous souhaitez développer des solutions qui étendent l’expérience Office sur plusieurs plateformes ? Consultez le nouveau modèle de compléments Office. Les compléments Office ont une petite empreinte par rapport aux compléments et solutions VSTO, et vous pouvez les créer à l’aide de presque toutes les technologies de programmation web, telles que HTML5, JavaScript, CSS3 et XML.

Lorsque vous créez un projet Office, Visual Studio ajoute des références aux informations d’identification personnelle requises pour générer le projet. Dans certains scénarios, vous devrez peut-être ajouter des références à d’autres AIP (par exemple, vous pouvez utiliser une fonctionnalité de Microsoft Office Word dans un projet pour Microsoft Office Excel).

Cet article décrit les aspects suivants de l’utilisation des AIP Microsoft Office dans les projets Office :

Pour plus d’informations sur les assemblies d’interopérabilité principales, consultez Assemblies d’interopérabilité principales.

Séparer les assemblages d’interopérabilité principaux pour compiler et exécuter des projets

Visual Studio utilise différents ensembles d'assemblies d'interopérabilité primaire sur l’ordinateur de développement. Ces différents ensembles d'assemblages se trouvent aux emplacements suivants :

  • Dossier dans le répertoire des fichiers du programme

    Cet ensemble d’assemblys est utilisé lorsque vous écrivez du code et générez des projets. Visual Studio installe automatiquement ces assemblys.

  • Cache d'assemblage global

    Cet ensemble d’assemblys est utilisé pendant certaines tâches de développement, telles que lorsque vous exécutez ou déboguez des projets. Visual Studio n’installe pas et n’inscrit pas ces assemblys ; vous devez le faire vous-même.

Assemblies d’interopérabilité principales dans le répertoire des fichiers de programme

Les informations d’identification personnelle sont automatiquement ajoutées à un emplacement dans le système de fichiers, en dehors du Global Assembly Cache, pendant que vous installez Visual Studio. Lorsque vous créez un projet, Visual Studio ajoute automatiquement des références à ces copies des informations d’identification personnelle à votre projet. Visual Studio utilise ces copies des AIP, au lieu des assemblys du Global Assembly Cache, pour résoudre les références de type lorsque vous développez et générez votre projet.

Lorsque différentes versions des PIAs sont inscrites dans le Global Assembly Cache, vous pouvez rencontrer plusieurs problèmes liés au développement. Les copies supplémentaires des AIP vous aideront à éviter de tels problèmes.

Pour Visual Studio 2017 et versions ultérieures, ces copies des informations d’identification personnelle sont installées sur les emplacements partagés suivants sur l’ordinateur de développement :

  • %ProgramFiles%\Microsoft Visual Studio\Shared\Visual Studio Tools for Office\PIA\

  • (ou %ProgramFiles(x86)%\Microsoft Visual Studio\Shared\Visual Studio Tools for Office\PIA\ sur les systèmes d’exploitation 64 bits)

Note

Pour les versions antérieures de Visual Studio, ces PIAs seront installés dans le dossier Visual Studio Tools pour Office\PIA sous le dossier %ProgramFiles% pour cette version de Visual Studio. Par exemple: %ProgramFiles(x86)%\Microsoft Visual Studio 14.0\Visual Studio Tools for Office\PIA\

Assemblys d’interopérabilité principaux dans le Global Assembly Cache

Pour effectuer certaines tâches de développement, les assemblies PIAs doivent être installées et inscrites dans le cache d'assembly global sur l'ordinateur de développement. Généralement, les intergiciels d'application principaux (PIAs) sont installés automatiquement lorsque vous installez Office sur l’ordinateur de développement. Pour plus d’informations, consultez Configurer un ordinateur pour développer des solutions Office.

Les assembleurs principaux d'interopérabilité (PIAs) de Office ne sont pas requis sur les ordinateurs des utilisateurs finaux pour exécuter des solutions Office. Pour plus d’informations, consultez Conception et création de solutions Office.

Utiliser des fonctionnalités de plusieurs applications Microsoft Office dans un seul projet

Chaque modèle de projet Office dans Visual Studio est conçu pour fonctionner avec une seule application Microsoft Office. Pour utiliser des fonctionnalités dans plusieurs applications Microsoft Office ou pour utiliser des fonctionnalités d’une application ou d’un composant qui n’ont pas de projet dans Visual Studio, vous devez ajouter une référence aux api d’identification personnelle requises.

Dans la plupart des cas, vous devez ajouter des références aux PIAs installées par Visual Studio dans le répertoire %ProgramFiles(x86)%\Microsoft Visual Studio\Shared\Visual Studio Tools for Office\PIA\. Ces versions des assemblys apparaissent sous l’onglet Framework de la boîte de dialogue Gestionnaire de références . Pour plus d’informations, consultez Guide pratique pour cibler des applications Office via des assemblys d’interopérabilité principaux.

Si vous avez installé et inscrit les informations d’identification personnelle dans le Global Assembly Cache, ces versions des assemblys apparaissent sous l’onglet COM de la boîte de dialogue Gestionnaire de références . Évitez d’ajouter des références à ces versions des assemblys, car il existe des problèmes de développement qui peuvent se produire lorsque vous les utilisez. Par exemple, si vous avez inscrit différentes versions des AIP dans le Global Assembly Cache, votre projet est automatiquement lié à la version de l’assembly qui a été inscrit en dernier, même si vous spécifiez une autre version de l’assembly sous l’onglet COM de la boîte de dialogue Gestionnaire de références .

Note

Certains assemblys sont ajoutés automatiquement à un projet lorsqu’un assembly qui les référence est ajouté. Par exemple, les références aux assemblages Office.dll et Microsoft.Vbe.Interop.dll sont ajoutées automatiquement lorsque vous ajoutez une référence aux assemblages Word, Excel, Outlook, Microsoft Forms ou Graph.

Assemblys d’interopérabilité principaux pour les applications Microsoft Office

Le tableau suivant répertorie les assemblys d’interopérabilité principaux disponibles pour Office 2016, Office 2013 et Office 2010.


Application ou composant Office Nom de l’assembly d’interopérabilité principale
Bibliothèque d’objets Microsoft Access 14.0

Bibliothèque d’objets Microsoft Access 15.0		 Microsoft.Office.Interop.Access.dll
Bibliothèque d’objets du moteur de base de données Microsoft Office 14.0 Access

Bibliothèque d’objets du moteur de base de données Microsoft Office 15.0 Access		 Microsoft.Office.Interop.Access.Dao.dll
Bibliothèque d’objets Microsoft Excel 14.0

Bibliothèque d’objets Microsoft Excel 15.0		 Microsoft.Office.Interop.Excel.dll
Bibliothèque d’objets Microsoft Graph 14.0 (utilisée par PowerPoint, Access et Word pour les graphiques)

Bibliothèque d’objets Microsoft Graph 15.0		 Microsoft.Office.Interop.Graph.dll
Bibliothèque de types Microsoft InfoPath 2.0 (pour InfoPath 2007 uniquement) Microsoft.Office.Interop.InfoPath.dll
Assembly d’interopérabilité XML Microsoft InfoPath (pour InfoPath 2007 uniquement) Microsoft.Office.Interop.InfoPath.Xml.dll
Bibliothèque d’objets Microsoft Office 14.0 (fonctionnalité partagée Office)

Bibliothèque d’objets Microsoft Office 15.0 (fonctionnalité partagée Office)		 office.dll
Contrôle d’affichage Microsoft Office Outlook (peut être utilisé dans les pages web et les applications pour accéder à votre boîte de réception) Microsoft.Office.Interop.OutlookViewCtl.dll
Bibliothèque d’objets Microsoft Outlook 14.0

Bibliothèque d’objets Microsoft Outlook 15.0		 Microsoft.Office.Interop.Outlook.dll
Bibliothèque d’objets Microsoft PowerPoint 14.0

Bibliothèque d’objets Microsoft PowerPoint 15.0		 Microsoft.Office.Interop.PowerPoint.dll
Bibliothèque d’objets Microsoft Project 14.0

Bibliothèque d’objets Microsoft Project 15.0		 Microsoft.Office.Interop.MSProject.dll
Bibliothèque d’objets Microsoft Publisher 14.0

Bibliothèque d’objets Microsoft Publisher 15.0		 Microsoft.Office.Interop.Publisher.dll
Bibliothèque de référence d’objets web Microsoft SharePoint Designer 14.0 Microsoft.Office.Interop.SharePointDesigner.dll
Bibliothèque de références des objets de page Microsoft SharePoint Designer 14.0 Microsoft.Office.Interop.SharePointDesignerPage.dll
Bibliothèque de types Microsoft Smart Tags 2.0Note : les balises intelligentes sont déconseillées dans Excel 2010 et Word 2010. Microsoft.Office.Interop.SmartTag.dll
Bibliothèque de types Microsoft Visio 14.0

Bibliothèque de types Microsoft Visio 15.0		 Microsoft.Office.Interop.Visio.dll
Microsoft Visio 14.0 Save As Web Type Library

Microsoft Visio 15.0 Bibliothèque de Type "Enregistrer sous Web"		 Microsoft.Office.Interop.Visio.SaveAsWeb.dll
Bibliothèque de types de contrôle de dessin Microsoft Visio 14.0

Bibliothèque de types de contrôle de dessin Microsoft Visio 15.0		 Microsoft.Office.Interop.VisOcx.dll
Bibliothèque d’objets Microsoft Word 14.0

Bibliothèque d’objets Microsoft Word 15.0		 Microsoft.Office.Interop.Word.dll
Extensibilité Microsoft Visual Basic pour Applications 5.3 Microsoft.Vbe.Interop.dll

Liaison d’assemblys de redirection

Lorsque vous installez et inscrivez les AIP Office dans le Global Assembly Cache (avec Office ou en installant le package redistribuable pour les AIP), les assemblys de redirection de liaison sont également installés uniquement dans le Global Assembly Cache. Ces assemblages garantissent que la version correcte des assemblages d’interopérabilité principaux est chargée à l'exécution.

Par exemple, lorsqu’une solution qui référence un assembly Office 2010 s’exécute sur un ordinateur doté de la version Office 2013 du même assembly d’interopérabilité principal, l’assembly de redirection de liaison indique au runtime .NET Framework de charger la version Office 2013 de l’assembly d’interopérabilité principal.

Pour plus d’informations, consultez Guide pratique pour activer et désactiver la redirection de liaison automatique.

Contenu connexe

  • Last updated on