Assemblys PIA (Primary Interop Assembly) Office
Pour utiliser les fonctionnalités d'une application Microsoft Office à partir d'un projet Office, vous devez utiliser l'assembly PIA de l'application. L'assembly PIA (Primary Interop Assembly) permet au code managé d'interagir avec le modèle objet COM d'une application Microsoft Office.
Lorsque vous créez un projet Office, Visual Studio ajoute des références aux assemblys PIA (Primary Interop Assembly) qui sont obligatoires pour générer le projet. Dans certains cas, vous pouvez être amené à ajouter des références aux assemblys PIA supplémentaires (par exemple, si vous souhaitez 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 les projets Office :
Assemblys PIA séparés pour générer et exécuter des projets
Utilisation des fonctions de plusieurs applications Microsoft Office dans un même projet
Liste complète des assemblys interop principales pour les applications Microsoft Office
Pour plus d'informations sur les assemblys PIA (Primary Interop Assembly), consultez Assemblys PIA (Primary Interop Assemblies).
Assemblys PIA (Primary Interop Assembly) séparés pour générer et exécuter des projets
Visual Studio utilise différents jeux d'assemblys PIA (Primary Interop Assembly) sur l'ordinateur de développement. Ces jeux différents d'assemblys se trouvent dans les emplacements suivants :
Un dossier dans le répertoire Program Files.
Ces copies des assemblys sont utilisées lorsque vous écrivez du code et générer des projets. Visual Studio installe automatiquement ces assemblys.
Global Assembly Cache.
Ces copies des assemblys sont utilisées pendant quelques tâches de développement, comme lorsque vous exécutez ou déboguez des projets qui ciblent .NET Framework 3.5. Visual Studio n'installe pas et n'enregistre pas ces assemblys ; vous devez le faire vous-même.
Assemblys PIA dans le répertoire Program Files
Lorsque vous installez Visual Studio, les assemblys PIA (Primary Interop Assembly) sont installés automatiquement à un emplacement dans le système de fichiers, en dehors du Global Assembly Cache. Lorsque vous créez un projet, Visual Studio ajoute automatiquement à votre projet des références à ces copies des assemblys PIA (Primary Interop Assembly). Visual Studio utilise ces copies des assemblys PIA (Primary Interop Assembly), au lieu des assemblys dans le Global Assembly Cache, pour résoudre des références de type lorsque vous développez et générez votre projet.
Ces copies des assemblys PIA (Primary Interop Assembly) aident Visual Studio à éviter plusieurs problèmes de développement qui peuvent se produire lorsque des versions différentes des assemblys PIA (Primary Interop Assembly) sont enregistrées dans le Global Assembly Cache.
Visual Studio installe ces copies d'assemblys PIA (Primary Interop Assembly) aux emplacements suivants sur l'ordinateur de développement :
%ProgramFiles%\Microsoft Visual Studio 10.0\Visual Studio Tools for Office\PIA\Office12
(ou %ProgramFiles(x86)%\Microsoft Visual Studio 10.0\Visual Studio Tools for Office\PIA\Office12 sur les systèmes d'exploitation 64 bits)
%ProgramFiles%\Microsoft Visual Studio 10.0\Visual Studio Tools for Office\PIA\Office14
(ou %ProgramFiles(x86)%\Microsoft Visual Studio 10.0\Visual Studio Tools for Office\PIA\Office14 sur les systèmes d'exploitation 64 bits)
Assemblys PIA dans le Global Assembly Cache
Pour effectuer certaines tâches de développement, les assemblys PIA (Primary Interop Assembly) 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 lorsque vous installez Office sur l'ordinateur de développement. Pour plus d'informations, consultez Configuration d'un ordinateur pour développer des solutions Office.
Les assemblys PIA (Primary Interop Assembly) des ordinateurs des utilisateurs finaux doivent également être installés et inscrits dans le Global Assembly Cache pour que vous puissiez exécuter des solutions Office qui ciblent le .NET Framework 3.5. Toutefois, les assemblys PIA d'Office ne sont pas obligatoires sur les ordinateurs des utilisateurs finaux pour l'exécution des solutions Office qui ciblent le .NET Framework 4. Pour plus d'informations, consultez Conception et création de solutions Office.
Utilisation des fonctions de plusieurs applications Microsoft Office dans un même projet
Chaque modèle de projet Office dans Visual Studio est conçu pour être utilisé avec une seule application Microsoft Office. Pour utiliser des fonctionnalités dans plusieurs applications Microsoft Office, ou pour utiliser des fonctionnalités dans une application ou un composant qui n'a pas de 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 PIA qui sont installés par Visual Studio sous le répertoire %ProgramFiles%\Microsoft Visual Studio 10.0\Visual Studio Tools for Offic\PIA\. Ces versions des assemblys apparaissent sous l'onglet .NET de la boîte de dialogue Ajouter une référence. Pour plus d'informations, consultez Comment : cibler les applications Office via les assemblys PIA (Primary Interop Assembly).
Si vous avez installé et avez inscrit les assemblys PIA dans le Global Assembly Cache, ces versions des assemblys apparaissent sous l'onglet COM de la boîte de dialogue Ajouter une référence. Vous devez éviter d'ajouter des références à ces versions des assemblys sous peine de générer des problèmes de développement en les utilisant. Par exemple, si vous avez inscrit différentes versions des assemblys PIA dans le Global Assembly Cache, le projet crée automatiquement une liaison avec la version du dernier assembly inscrit, même si vous spécifiez une version différente de l'assembly sous l'onglet COM de la boîte de dialogue Ajouter une référence.
Notes
Certains assemblys sont automatiquement ajoutés à un projet lorsqu'un assembly qui les référence est ajouté. Par exemple, des références aux assemblys Office.dll et Microsoft.Vbe.Interop.dll sont automatiquement ajoutées lorsque vous ajoutez une référence aux assemblys Word, Excel, Outlook, Microsoft Forms ou Graph.
Assemblys PIA pour applications Microsoft Office
Le tableau suivant répertorie les assemblys PIA qui sont disponibles pour Microsoft Office 2010 et la version 2007 de Microsoft Office System.
Application ou composant Office |
Nom de l'assembly PIA |
|---|---|
Bibliothèque d'objets Microsoft Access 12.0 Bibliothèque d'objets Microsoft Access 14.0 |
Microsoft.Office.Interop.Access.dll |
Bibliothèque d'objets du moteur de la base de données Microsoft Office Access 2007 Bibliothèque d'objets du moteur de la base de données Microsoft Office Access 14.0 |
Microsoft.Office.Interop.Access.Dao.dll |
Bibliothèque d'objets Microsoft Excel 12.0 Bibliothèque d'objets Microsoft Excel 14.0 |
Microsoft.Office.Interop.Excel.dll |
Bibliothèque d'objets Microsoft Graph 12.0.0 (utilisée par PowerPoint, Access et Word pour les graphiques) Bibliothèque d'objets Microsoft Graph 14.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 12.0 (fonctionnalité partagée Office) Bibliothèque d'objets Microsoft Office 14.0 (fonctionnalité partagée Office) |
office.dll |
Contrôle d'affichage Microsoft Office Outlook (peut être utilisé dans les pages et les applications Web pour accéder à votre boîte de réception) |
Microsoft.Office.Interop.OutlookViewCtl.dll |
Bibliothèque d'objets Microsoft Outlook 12.0 Bibliothèque d'objets Microsoft Outlook 14.0 |
Microsoft.Office.Interop.Outlook.dll |
Bibliothèque d'objets Microsoft PowerPoint 12.0 Bibliothèque d'objets Microsoft PowerPoint 14.0 |
Microsoft.Office.Interop.PowerPoint.dll |
Bibliothèque d'objets Microsoft Project 12.0 Bibliothèque d'objets Microsoft Project 14.0 |
Microsoft.Office.Interop.MSProject.dll |
Bibliothèque d'objets Microsoft Publisher 12.0 Bibliothèque d'objets Microsoft Publisher 14.0 |
Microsoft.Office.Interop.Publisher.dll |
Bibliothèque de référence d'objets Web Microsoft SharePoint Designer 12.0 Bibliothèque de référence d'objets Web Microsoft SharePoint Designer 14.0 |
Microsoft.Office.Interop.SharePointDesigner.dll |
Bibliothèque de référence d'objets page Microsoft SharePoint Designer 12.0 Bibliothèque de référence d'objets page Microsoft SharePoint Designer 14.0 |
Microsoft.Office.Interop.SharePointDesignerPage.dll |
Bibliothèque de types Microsoft Smart Tags 2.0 .gif "Remarque") Remarque
Les balises actives sont déconseillées dans Excel 2010 et Word 2010.Pour plus d'informations, consultez Vue d'ensemble des balises actives.
|
Microsoft.Office.Interop.SmartTag.dll |
Bibliothèque de types Microsoft Visio 12.0 Bibliothèque de types Microsoft Visio 14.0 |
Microsoft.Office.Interop.Visio.dll |
Bibliothèque de types Web Enregistrer sous Microsoft Visio 12.0 Bibliothèque de types Web Enregistrer sous Microsoft Visio 14.0 |
Microsoft.Office.Interop.Visio.SaveAsWeb.dll |
Bibliothèque de types Contrôle des dessins Microsoft Visio 12.0 Bibliothèque de types Contrôle des dessins Microsoft Visio 14.0 |
Microsoft.Office.Interop.VisOcx.dll |
Bibliothèque d'objets Microsoft Word 12.0 Bibliothèque d'objets Microsoft Word 14.0 |
Microsoft.Office.Interop.Word.dll |
Microsoft Visual Basic for Applications Extensibilité 5.3 |
Microsoft.Vbe.Interop.dll |
Redirection de liaison d'assemblys
Lorsque vous installez et enregistrez les assemblys PIA (Primary Interop Assembly) Office dans le Global Assembly Cache (avec Office ou en installant le package redistribuable pour les assemblys PIA), les assemblys de redirection de liaison sont également installés uniquement dans le Global Assembly Cache. Ces assemblys aident à s'assurer que la version correcte des assemblys PIA est chargée au moment de l'exécution. Par exemple, lorsqu'une solution qui fait référence à un assembly PIA de Microsoft Office 2007 est exécutée sur un ordinateur disposant de la version Microsoft Office 2010 de cet assembly PIA, l'assembly de redirection de liaison indique au runtime .NET Framework de charger la version Microsoft Office 2010 de l'assembly PIA. Pour plus d'informations, consultez Redirection de liaison d'assembly.
Chaque assembly de redirection de liaison porte un nom au format Policy.11.0.Nom de l'assembly PIA.dll ou Policy.12.0.Nom de l'assembly PIA.dll, tel que Policy.11.0.Microsoft.Office.Interop.Excel.dll et Policy.12.0.Microsoft.Office.Interop.Excel.dll.
Voir aussi
Tâches
Comment : cibler les applications Office via les assemblys PIA (Primary Interop Assembly)
Concepts
Vue d'ensemble du modèle objet Visio
Autres ressources
Vue d'ensemble du modèle objet Excel
Vue d'ensemble du modèle d'objet Outlook
Vue d'ensemble du modèle objet Word
Référence générale (Développement Office dans Visual Studio)