assemblys PIA (Primary Interop Assembly) Office

Pour utiliser les fonctionnalités d'une application Microsoft Office dans un projet Office, vous devez utiliser l'assembly PIA (Primary Interop Assembly) de l'application. L'assembly PIA permet au code managé d'interagir avec le modèle d'objet COM d'une application Microsoft Office.

Notes

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

Quand vous créez un projet Office, Visual Studio ajoute des références aux assemblys PIA requis pour générer le projet. Dans certains scénarios, vous devrez peut-être ajouter des références à des assemblys PIA supplémentaires (par exemple, si vous voulez utiliser une fonctionnalité de Microsoft Office Word dans un projet pour Microsoft Office Excel).

Cette rubrique décrit les aspects suivants de l'utilisation des assemblys PIA Microsoft Office dans des projets Office :

Pour plus d’informations sur les assemblys PIA, consultez Assemblys PIA ( Primary Interop Assembly).

Séparer les assemblys PIA pour générer et exécuter des projets

Visual Studio utilise différents ensembles d'assemblys PIA sur l'ordinateur de développement. Ces différents ensembles d'assemblys se trouvent aux emplacements suivants :

  • Un dossier dans le répertoire Program Files

    Ces copies des assemblys sont utilisées quand vous écrivez du code et que vous générez des projets. Visual Studio installe ces assemblys automatiquement.

  • Global Assembly Cache

    Ces copies des assemblys sont utilisées pendant certaines tâches de développement, par exemple quand vous exécutez ou déboguez des projets. Visual Studio n'installe ni n'enregistre ces assemblys. Vous devez le faire vous-même.

Assemblys PIA dans le répertoire Program Files

Quand vous installez Visual Studio, les assemblys PIA sont automatiquement installés dans le système de fichiers, en dehors du Global Assembly Cache. Quand vous créez un projet, Visual Studio ajoute automatiquement à votre projet des références à ces copies des assemblys PIA. Visual Studio utilise ces copies des assemblys PIA, au lieu des assemblys du Global Assembly Cache, pour résoudre des références de type quand vous développez et générez votre projet.

Ces copies des assemblys PIA aident Visual Studio à éviter plusieurs problèmes de développement pouvant se produire quand différentes versions d'assemblys PIA sont enregistrées dans le Global Assembly Cache.

À compter de Visual Studio 2017, ces copies des assemblys PIA sont installées vers 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)

Notes

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

Assemblys PIA dans le Global Assembly Cache

Pour effectuer certaines tâches de développement, les assemblys PIA doivent être installés et enregistrés dans le Global Assembly Cache sur l'ordinateur de développement. En général, les assemblys PIA sont installés automatiquement quand vous installez Office sur l'ordinateur de développement. Pour plus d’informations, consultez configurer un ordinateur pour développer des solutions Office.

Les assemblys PIA Office ne sont pas obligatoires sur les ordinateurs des utilisateurs finaux pour exécuter les solutions Office. Pour plus d’informations, consultez conception et création de solutions Office.

Utiliser les fonctionnalités de plusieurs applications de Microsoft Office dans un projet unique

Tous les modèles de projet Office dans Visual Studio sont conçus pour fonctionner avec une seule application Microsoft Office. Pour utiliser des fonctionnalités dans plusieurs applications Microsoft Office ou dans une application ou composant qui ne dispose pas d'un projet dans Visual Studio, vous devez ajouter une référence aux assemblys PIA requis.

Dans la plupart des cas, vous devez ajouter des références aux assemblys PIA installés par Visual Studio dans le %ProgramFiles(x86)%\Microsoft Visual Studio\Shared\Visual Studio Tools for Office\PIA\ répertoire. 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 Comment : cibler des applications Office par le biais d’assemblys PIA.

Si vous avez installé et enregistré les assemblys PIA 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 . Vous devez éviter d'ajouter des références à ces versions d'assemblys, car des erreurs de développement peuvent se produire quand vous les utilisez. Par exemple, si vous avez enregistré différentes versions des assemblys PIA dans le Global Assembly Cache, votre projet crée automatiquement une liaison à la dernière version enregistrée de l'assembly, 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 .

Notes

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

Assemblys PIA pour les applications Microsoft Office

Le tableau suivant répertorie les assemblys PIA disponibles pour Office 2016 , Office 2013 et Office 2010 .


Application ou composant Office Nom de l'assembly PIA
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 Access 14.0

Bibliothèque d'objets du moteur de base de données Microsoft Office Access 15.0
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 (uniquement pour InfoPath 2007) Microsoft.Office.Interop.InfoPath.dll
Assembly d'interopérabilité XML Microsoft InfoPath (uniquement pour InfoPath 2007) Microsoft.Office.Interop.InfoPath.Xml.dll
Bibliothèque d'objets Microsoft Office 14.0 (composant partagé Office)

Bibliothèque d'objets Microsoft Office 15.0 (composant partagé Office)
office.dll
Contrôle view Microsoft Office Outlook (peut être utilisé dans les pages web et 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érences d'objet web Microsoft SharePoint Designer 14.0 Microsoft.Office.Interop.SharePointDesigner.dll
Bibliothèque de références d'objet Page Microsoft SharePoint Designer 14.0 Microsoft.Office.Interop.SharePointDesignerPage.dll
Bibliothèque de types Microsoft Smart Tags 2,0 Note : les balises actives sont déprécié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
Bibliothèque de types Enregistrer en tant que page web Microsoft Visio 14.0

Bibliothèque de types Enregistrer en tant que page web Microsoft Visio 15.0
Microsoft.Office.Interop.Visio.SaveAsWeb.dll
Bibliothèque de types de contrôles de dessin Microsoft Visio 14.0

Bibliothèque de types de contrôles 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
Microsoft Visual Basic for Applications Extensibility 5.3 Microsoft.Vbe.Interop.dll

Assemblys de redirection de liaison

Quand vous installez et enregistrez les assemblys PIA Office dans le Global Assembly Cache (avec Office ou en installant le package redistribuable pour les assemblys PIA), les assemblys avec redirection de liaison sont également installés uniquement dans le Global Assembly Cache. Ces assemblys permettent de s’assurer que la version correcte des assemblys PIA est chargée au moment de l’exécution.

Par exemple, quand une solution faisant référence à un assembly Office 2010 s'exécute sur un ordinateur disposant de la version Office 2013 du même assembly PIA, l'assembly avec redirection de liaison indique au runtime .NET Framework de charger la version Office 2013 de l'assembly PIA.

Pour plus d’informations, consultez Comment : activer et désactiver la redirection de liaison automatique.

Voir aussi