Partager via

assemblys PIA (Primary Interop Assembly) Office

  • Article

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.

Remarque

Vous souhaitez développer des solutions qui étendent l’expérience de Bureau sur plusieurs plateformes ? Consultez le nouveau modèle de compléments Bureau. Bureau compléments ont une petite empreinte par rapport aux compléments et solutions VSTO, et vous pouvez les créer à l’aide de presque n’importe quelle technologie de programmation web, telle 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 à d’autres AIP (par exemple, vous pouvez utiliser une fonctionnalité de Microsoft Bureau Word dans un projet pour Microsoft Bureau Excel).

Cet article décrit les aspects suivants de l’utilisation des informations d’identification personnelles microsoft Bureau dans les projets Bureau :

Pour plus d’informations sur les assemblys d’interopérabilité principal, consultez Assemblys d’interopérabilité primaire.

Séparer les assemblys d’interopérabilité principaux 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 :

  • 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 ces assemblys automatiquement.

  • Global Assembly Cache

    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.

Assemblys d’interopérabilité principaux dans le répertoire des fichiers 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. 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.

Lorsque différentes versions des api d’identification personnelle sont inscrites dans le Global Assembly Cache, vous pouvez rencontrer plusieurs problèmes de développement. Les copies ajoutées 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)

Remarque

Pour les versions antérieures de Visual Studio, ces informations d’identification personnelle sont installées 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 d’interopérabilité principaux 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 Bureau.

Les Bureau les adresses PERSONNELLEs ne sont pas requises sur les ordinateurs des utilisateurs finaux pour exécuter des solutions Bureau. Pour plus d’informations, consultez Conception et création de solutions Bureau.

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

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 application Office lications Microsoft ou pour utiliser des fonctionnalités dans une application ou 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 api d’identification personnelle installées par Visual Studio sous 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 Guide pratique pour cibler des application Office lications 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.

Remarque

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 assemblys et Microsoft.Vbe.Interop.dll aux Office.dll assemblys sont ajoutées automatiquement lorsque vous ajoutez une référence aux assemblys Word, Excel, Outlook, Microsoft Forms ou Graph.

Assemblys d’interopérabilité principaux pour les application Office lications Microsoft

Le tableau suivant répertorie les assemblys d’interopérabilité principaux disponibles pour Bureau 2016, Bureau 2013 et Bureau 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. Bureau. 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. Bureau. 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. Bureau. 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. Bureau. 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
Notes de bibliothèque de types Microsoft Smart Tags 2.0 : les balises actives 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
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. Bureau. Interop.Word.dll
Microsoft Visual Basic for Applications Extensibility 5.3 Microsoft.Vbe.Interop.dll

Liaison d’assemblys de redirection

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 garantissent que la version correcte des assemblys d’interopérabilité principal est chargée au moment de l’exécution.

Par exemple, lorsqu’une solution qui référence un assembly Bureau 2010 s’exécute sur un ordinateur qui a la version Bureau 2013 du même assembly d’interopérabilité principal, l’assembly de redirection de liaison indique au runtime .NET Framework de charger la version Bureau 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