Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez aussi afficher la version anglaise dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte.
Traduction
Anglais

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.

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 Assemblies).

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.

  • Le 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.

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.

Visual Studio installe ces copies des assemblys PIA aux emplacements suivants sur l'ordinateur de développement :

  • %ProgramFiles%\Microsoft Visual Studio 12.0\Visual Studio Tools for Office\PIA\Office14

    (ou %ProgramFiles(x86)%\Microsoft Visual Studio 12.0\Visual Studio Tools for Office\PIA\Office14 sur les systèmes d'exploitation 64 bits)

  • %ProgramFiles%\Microsoft Visual Studio 12.0\Visual Studio Tools for Office\PIA\Office15

    (ou %ProgramFiles(x86)%\Microsoft Visual Studio 12.0\Visual Studio Tools for Office\PIA\Office15 sur les systèmes d'exploitation 64 bits)

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 Configuration d'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.

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 répertoire %ProgramFiles%\Microsoft Visual Studio 12.0\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 Comment : cibler les applications Office via les assemblys PIA (Primary Interop Assembly).

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.

System_CAPS_noteRemarque

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

La table suivante indique les assemblys PIA disponibles pour 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

System_CAPS_noteRemarque

Les balises actives ne sont plus utilisé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

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 faire en sorte 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.

Afficher: