Assemblys PIA (Primary Interop Assembly) Office

Article
08/21/2008

Mise à jour : novembre 2007

Pour utiliser les fonctions d'une application Microsoft Office à partir d'une solution Visual Studio Tools pour Office, vous devez utiliser l'assembly PIA de l'application. Ce dernier permet au code managé d'interagir avec le modèle d'objet COM d'une application Microsoft Office.

Lorsque vous créez un projet Visual Studio Tools pour Office, Visual Studio ajoute des références aux assemblys PIA requis 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 fonction de Microsoft Office Word dans un projet pour Microsoft Office Excel).

Cette rubrique décrit les aspects suivants de l'utilisation des assemblys PIA de Microsoft 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
Assemblys PIA de Microsoft Office 2003
Assemblys PIA de la version 2007 de Microsoft Office system

Pour plus d'informations sur les assemblys PIA, 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 Tools pour Office utilise des jeux différents d'assemblys PIA 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 le code et générer des projets. Visual Studio Tools pour Office installe automatiquement ces assemblys.
Global Assembly Cache.

Ces copies des assemblys sont utilisées lorsque vous exécutez ou déboguez des projets. Visual Studio Tools pour Office n'installe pas et n'enregistre pas ces assemblys ; vous devez exécuter ces opérations vous-même.

Assemblys PIA dans le répertoire Program Files

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

Ces copies des assemblys PIA permettent à Visual Studio Tools pour Office d'éviter des problèmes de développement qui peuvent se produire lorsque les versions 2003 et 2007 des assemblys PIA Office sont inscrites dans le Global Assembly Cache.

Visual Studio Tools pour Office installe ces copies des assemblys PIA dans les emplacements suivants sur l'ordinateur de développement :

%ProgramFiles%\Microsoft Visual Studio 9.0\Visual Studio Tools for Office\PIA\Office11
%ProgramFiles%\Microsoft Visual Studio 9.0\Visual Studio Tools for Office\PIA\Office12

Assemblys PIA dans le Global Assembly Cache

Pour effectuer la plupart des tâches de développement, vous devez installer et inscrire les assemblys PIA dans le Global Assembly Cache. Pour ce faire, effectuez une installation complète de Microsoft Office ou installez le package redistribuable des assemblys PIA. Pour plus d'informations, consultez Comment : installer les assemblys PIA (Primary Interop Assembly) d'Office.

Vous devez avoir installé et inscrit les assemblys PIA dans le Global Assembly Cache pour pouvoir effectuer les tâches de développement suivantes :

créer un projet de personnalisation au niveau du document ;
exécuter ou déboguer un projet Visual Studio Tools pour Office.

Les utilisateurs finaux doivent avoir également installé et inscrit les assemblys PIA dans le Global Assembly Cache sur leurs ordinateurs pour pouvoir exécuter des solutions Visual Studio Tools pour Office.

Utilisation des fonctions de plusieurs applications Microsoft Office dans un même projet

Chaque modèle de projet dans Visual Studio Tools pour Office est conçu pour utiliser une seule application Microsoft Office. Pour utiliser des fonctions dans plusieurs applications Microsoft Office, ou pour utiliser des fonctions dans une application ou un composant qui n'a pas de projet dans Visual Studio Tools pour Office, 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 Tools pour Office dans le répertoire % ProgramFiles%. 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 des versions 2003 et 2007 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.

Remarque :
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 (Primary Interop Assembly) de Microsoft Office 2003

Le tableau suivant répertorie les assemblys PIA qui sont disponibles pour Microsoft Office 2003.

Application ou composant Office	Nom de l'assembly PIA
Bibliothèque d'objets Microsoft Access 11.0	Microsoft.Office.Interop.Access.dll
Bibliothèque d'objets Microsoft Excel 11.0	Microsoft.Office.Interop.Excel.dll
Bibliothèque de référence d'objets Web Microsoft FrontPage 6.0	Microsoft.Office.Interop.Frontpage.dll
Bibliothèque de référence d'objets Page Microsoft FrontPage 6.0	Microsoft.Office.Interop.Frontpageeditor.dll
Bibliothèque d'objets Microsoft Graph 11.0  (utilisée par PowerPoint, Access et Word pour les graphiques)	Microsoft.Office.Interop.Graph.dll
Bibliothèque d'objets Microsoft Outlook 11.0	Microsoft.Office.Interop.Outlook.dll
Contrôle d'affichage Microsoft 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
Microsoft Office Web Components 11.0  (feuille de calcul, graphique et tableau croisé dynamique pour les pages Web)	Microsoft.Office.Interop.owc11.dll
Bibliothèque d'objets Microsoft PowerPoint 11.0	Microsoft.Office.Interop.PowerPoint.dll
Bibliothèque d'objets Microsoft Project 11.0	Microsoft.Office.Interop.MSProject.dll
Bibliothèque d'objets Microsoft Publisher 11.0	Microsoft.Office.Interop.Publisher.dll
Bibliothèque de types Microsoft Smart Tags 2.0	Microsoft.Office.Interop.SmartTag.dll
Bibliothèque d'objets Microsoft Word 11.0	Microsoft.Office.Interop.Word.dll
Microsoft Visual Basic for Applications Extensibilité 5.3	Microsoft.Vbe.Interop.dll
Bibliothèque d'objets Microsoft Forms 2.0  (contrôles programmables pouvant être utilisés dans les applications)	Microsoft.Vbe.Interop.Forms.dll
Bibliothèque d'objets Microsoft Office 11.0  (fonctionnalité partagée Office)	office.dll

Assemblys PIA de la version 2007 de Microsoft Office System

Le tableau suivant répertorie les assemblys PIA qui sont disponibles pour la version 2007 de Microsoft Office System.

Application ou composant Office	Nom de l'assembly PIA
Bibliothèque d'objets Microsoft Access 12.0	Microsoft.Office.Interop.Access.dll
Bibliothèque d'objets du moteur de la base de données Microsoft Office Access 2007	Microsoft.Office.Interop.Access.Dao.dll
Bibliothèque d'objets Microsoft Excel 12.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)	Microsoft.Office.Interop.Graph.dll
Bibliothèque de types Microsoft InfoPath 2.0	Microsoft.Office.Interop.InfoPath.dll
Assembly PIA XML Microsoft InfoPath	Microsoft.Office.Interop.InfoPath.Xml.dll
Bibliothèque d'objets Microsoft Outlook 12.0	Microsoft.Office.Interop.Outlook.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 PowerPoint 12.0	Microsoft.Office.Interop.PowerPoint.dll
Bibliothèque d'objets Microsoft Project 12.0	Microsoft.Office.Interop.MSProject.dll
Bibliothèque d'objets Microsoft Publisher 12.0	Microsoft.Office.Interop.Publisher.dll
Bibliothèque de référence d'objets Web Microsoft SharePointDesigner 12.0	Microsoft.Office.Interop.SharePointDesigner.dll
Bibliothèque de référence d'objets page Microsoft SharePointDesigner 12.0	Microsoft.Office.Interop.SharePointDesignerPage.dll
Bibliothèque de types Microsoft Smart Tags 2.0	Microsoft.Office.Interop.SmartTag.dll
Bibliothèque de types Microsoft Visio 12.0	Microsoft.Office.Interop.Visio.dll
Bibliothèque de types Web Enregistrer sous Microsoft Visio 12.0	Microsoft.Office.Interop.Visio.SaveAsWeb.dll
Bibliothèque de types Contrôle des dessins Microsoft Visio 12.0	Microsoft.Office.Interop.VisOcx.dll
Bibliothèque d'objets Microsoft Word 12.0	Microsoft.Office.Interop.Word.dll
Microsoft Visual Basic for Applications Extensibilité 5.3	Microsoft.Vbe.Interop.dll
Bibliothèque d'objets Microsoft Office 12.0  (fonctionnalité partagée Office)	office.dll
Assembly de redirection de liaison pour la bibliothèque d'objets Microsoft Access	Policy.11.0.Microsoft.Office.Interop.Access.dll
Assembly de redirection de liaison pour la bibliothèque d'objets Microsoft Excel	Policy.11.0.Microsoft.Office.Interop.Excel.dll
Assembly de redirection de liaison pour la bibliothèque d'objets Microsoft Graph	Policy.11.0.Microsoft.Office.Interop.Graph.dll
Assembly de redirection de liaison pour la bibliothèque de types Microsoft InfoPath	Policy.11.0.Microsoft.Office.Interop.InfoPath.dll
Assembly de redirection de liaison pour l'assembly PIA XML Microsoft InfoPath	Policy.11.0.Microsoft.Office.Interop.InfoPath.Xml.dll
Assembly de redirection de liaison pour la bibliothèque d'objets Microsoft Outlook	Policy.11.0.Microsoft.Office.Interop.Outlook.dll
Assembly de redirection de liaison pour le Contrôle d'affichage Microsoft Outlook	Policy.11.0.Microsoft.Office.Interop.OutlookViewCtl.dll
Assembly de redirection de liaison pour la bibliothèque d'objets Microsoft PowerPoint	Policy.11.0.Microsoft.Office.Interop.PowerPoint.dll
Assembly de redirection de liaison pour la bibliothèque d'objets Microsoft Project	Policy.11.0.Microsoft.Office.Interop.MSProject.dll
Assembly de redirection de liaison pour la bibliothèque d'objets Microsoft Publisher	Policy.11.0.Microsoft.Office.Interop.Publisher.dll
Assembly de redirection de liaison pour la bibliothèque de types Microsoft Smart Tags	Policy.11.0.Microsoft.Office.Interop.SmartTag.dll
Bibliothèque de types Microsoft Visio	Policy.11.0.Microsoft.Office.Interop.Visio.dll
Assembly de redirection de liaison pour la bibliothèque de types Web Enregistrer sous Microsoft Visio	Policy.11.0.Microsoft.Office.Interop.Visio.SaveAsWeb.dll
Assembly de redirection de liaison pour la bibliothèque de types Contrôle des dessins Microsoft Visio	Policy.11.0.Microsoft.Office.Interop.VisOcx.dll
Assembly de redirection de liaison pour la bibliothèque d'objets Microsoft Word	Policy.11.0.Microsoft.Office.Interop.Word.dll
Assembly de redirection de liaison pour Microsoft Visual Basic pour les applications Extensibilité 5.3	Policy.11.0.Microsoft.Vbe.Interop.dll
Assembly de redirection de liaison pour la bibliothèque d'objets Microsoft Office	Policy.11.0.office.dll

Remarque :
Les assemblys de redirection de liaison garantissent le chargement de la version Microsoft Office 2007 des assemblys PIA au moment de l'exécution. Lorsqu'une solution Visual Studio Tools pour Office qui fait référence à un assembly PIA de Microsoft Office 2003 est exécutée sur un ordinateur disposant de la version Microsoft Office 2007 de cet assembly PIA, l'assembly de redirection de liaison indique au runtime de .NET Framework de charger la version Microsoft Office 2007 de l'assembly PIA. Pour plus d'informations, consultez Redirection de liaison d'assembly.

Les assemblys de redirection de liaison garantissent le chargement de la version Microsoft Office 2007 des assemblys PIA au moment de l'exécution. Lorsqu'une solution Visual Studio Tools pour Office qui fait référence à un assembly PIA de Microsoft Office 2003 est exécutée sur un ordinateur disposant de la version Microsoft Office 2007 de cet assembly PIA, l'assembly de redirection de liaison indique au runtime de .NET Framework de charger la version Microsoft Office 2007 de l'assembly PIA. Pour plus d'informations, consultez Redirection de liaison d'assembly.

Voir aussi

Tâches

Comment : cibler les applications Office via les assemblys PIA (Primary Interop Assembly)

Autres ressources

Référence générale (Visual Studio Tools pour Office)