Delen via

Primaire interop-assemblies van Office

Als u de functies van een Microsoft Office-toepassing uit een Office-project wilt gebruiken, moet u de primaire interopassembly (PIA) voor de toepassing gebruiken. De PIA maakt het mogelijk voor beheerde code om te communiceren met het COM-objectmodel van een Microsoft Office-toepassing.

Opmerking

Bent u geïnteresseerd in het ontwikkelen van oplossingen die de Office-ervaring uitbreiden op meerdere platforms? Bekijk het nieuwe Office-invoegtoepassingsmodel. Office-invoegtoepassingen hebben een kleine footprint vergeleken met VSTO-invoegtoepassingen en -oplossingen en u kunt ze bouwen met behulp van vrijwel elke webprogrammeertechnologie, zoals HTML5, JavaScript, CSS3 en XML.

Wanneer u een nieuw Office-project maakt, worden in Visual Studio verwijzingen toegevoegd aan de PIA's die nodig zijn om het project te bouwen. In sommige scenario's moet u mogelijk verwijzingen toevoegen aan andere PIA's (u kunt bijvoorbeeld een functie van Microsoft Office Word gebruiken in een project voor Microsoft Office Excel).

In dit artikel worden de volgende aspecten beschreven van het gebruik van de Microsoft Office-PIA's in Office-projecten:

Zie Primaire interop-assembly's voor meer informatie over primaire interop-assemblies.

Afzonderlijke primaire interoperabiliteitsassemblages om projecten te bouwen en uit te voeren

Visual Studio maakt gebruik van verschillende sets piA's op de ontwikkelcomputer. De verschillende sets van assemblages bevinden zich op de volgende locaties:

  • Een map in de programmabestanden directory

    Deze set assembly's wordt gebruikt wanneer u code schrijft en projecten bouwt. Visual Studio installeert deze assembly's automatisch.

  • De globale assembly-cache

    Deze set assemblies wordt gebruikt tijdens sommige ontwikkelings-taken, zoals wanneer u projecten uitvoert of debuggen. Visual Studio installeert en registreert deze assembly's niet; Je moet het zelf doen.

Primaire interoperabiliteitsassembly's in de map met programmabestanden

De PIA's worden automatisch toegevoegd aan een locatie in het bestandssysteem, buiten de globale assemblycache, terwijl u Visual Studio installeert. Wanneer u een nieuw project maakt, worden in Visual Studio automatisch verwijzingen toegevoegd aan deze kopieën van de PIA's aan uw project. Visual Studio gebruikt deze kopieën van de PIA's, in plaats van de assembly's in de globale assemblycache, om typeverwijzingen op te lossen wanneer u uw project ontwikkelt en bouwt.

Wanneer verschillende versies van de PIA's zijn geregistreerd in de globale assemblycache, kunt u verschillende ontwikkelproblemen ondervinden. De toegevoegde kopieën van PIA's helpen u dergelijke problemen te voorkomen.

Voor Visual Studio 2017 en hoger worden deze kopieën van de PIA's geïnstalleerd op de volgende gedeelde locaties op de ontwikkelcomputer:

  • %ProgramFiles%\Microsoft Visual Studio\Shared\Visual Studio Tools for Office\PIA\

  • (ofwel %ProgramFiles(x86)%\Microsoft Visual Studio\Shared\Visual Studio Tools for Office\PIA\ op 64-bit besturingssystemen)

Opmerking

Voor oudere versies van Visual Studio worden deze PIA's geïnstalleerd in de map Visual Studio Tools for Office\PIA binnen de %ProgramFiles% folder voor die versie van Visual Studio. Bijvoorbeeld: %ProgramFiles(x86)%\Microsoft Visual Studio 14.0\Visual Studio Tools for Office\PIA\

Primaire interop-assemblages in de globale assembly cache

Als u bepaalde ontwikkelingstaken wilt uitvoeren, moeten de PIA's worden geïnstalleerd en geregistreerd in de algemene assemblycache op de ontwikkelcomputer. Normaal gesproken worden de PIA's automatisch geïnstalleerd wanneer u Office op de ontwikkelcomputer installeert. Zie Een computer configureren voor het ontwikkelen van Office-oplossingen voor meer informatie.

De Office-PIA's zijn niet vereist op computers van eindgebruikers om Office-oplossingen uit te voeren. Zie Ontwerp en maak Office-oplossingen voor meer informatie.

Functies van meerdere Microsoft Office-toepassingen in één project gebruiken

Elke Office-projectsjabloon in Visual Studio is ontworpen voor gebruik met één Microsoft Office-toepassing. Als u functies in meerdere Microsoft Office-toepassingen wilt gebruiken of functies wilt gebruiken in een toepassing of onderdeel dat geen project in Visual Studio heeft, moet u een verwijzing toevoegen naar de vereiste PIA's.

In de meeste gevallen moet u verwijzingen toevoegen naar de PIA's die zijn geïnstalleerd door Visual Studio onder de %ProgramFiles(x86)%\Microsoft Visual Studio\Shared\Visual Studio Tools for Office\PIA\ map. Deze versies van de assembly's worden weergegeven op het tabblad Framework van het dialoogvenster Verwijzingsbeheer . Zie voor meer informatie Hoe: Office-toepassingen richten op via primaire interop-assemblages.

Als u de PIA's hebt geïnstalleerd en geregistreerd in de algemene assemblycache, worden deze versies van de assembly's weergegeven op het tabblad COM van het dialoogvenster Reference Manager . Vermijd het toevoegen van verwijzingen naar deze versies van de assembly's, omdat er enkele ontwikkelproblemen kunnen optreden wanneer u ze gebruikt. Als u bijvoorbeeld verschillende versies van de PIA's hebt geregistreerd in de globale assemblycache, wordt uw project automatisch gebonden aan de versie van de assembly die voor het laatst is geregistreerd, zelfs als u een andere versie van de assembly opgeeft op het tabblad COM van het dialoogvenster Reference Manager .

Opmerking

Sommige assembly's worden automatisch aan een project toegevoegd wanneer een assembly waarnaar wordt verwezen, wordt toegevoegd. Verwijzingen naar de Office.dll assembly's en Microsoft.Vbe.Interop.dll assembly's worden bijvoorbeeld automatisch toegevoegd wanneer u een verwijzing toevoegt naar de assembly's Word, Excel, Outlook, Microsoft Forms of Graph.

Primaire interop-assemblies voor Microsoft Office-toepassingen

De volgende tabel bevat de primaire interoperabiliteitsassembly's die beschikbaar zijn voor Office 2016, Office 2013 en Office 2010.


Office-toepassing of kantooronderdeel Primaire assemblynaam voor interop
Microsoft Access 14.0 Objectbibliotheek

Microsoft Access 15.0-objectbibliotheek		 Microsoft.Office.Interop.Access.dll
Microsoft Office 14.0 Access Database Engine Object Library

Microsoft Office 15.0 Access Database Engine Object Library		 Microsoft.Office.Interop.Access.Dao.dll
Microsoft Excel 14.0 Objectbibliotheek

Microsoft Excel 15.0 Objectbibliotheek		 Microsoft.Office.Interop.Excel.dll
Microsoft Graph 14.0-objectbibliotheek (gebruikt door PowerPoint, Access en Word voor grafieken)

Microsoft Graph 15.0-objectbibliotheek		 Microsoft.Office.Interop.Graph.dll
Microsoft InfoPath 2.0-typebibliotheek (alleen voor InfoPath 2007) Microsoft.Office.Interop.InfoPath.dll
Microsoft InfoPath XML Interop Assembly (alleen voor InfoPath 2007) Microsoft.Office.Interop.InfoPath.Xml.dll
Microsoft Office 14.0-objectbibliotheek (gedeelde office-functionaliteit)

Microsoft Office 15.0-objectbibliotheek (gedeelde functionaliteit van Office)		 office.dll
Microsoft Office Outlook View Control (kan worden gebruikt in webpagina's en toepassingen om toegang te krijgen tot uw postvak in) Microsoft.Office.Interop.OutlookViewCtl.dll
Microsoft Outlook 14.0 Objectbibliotheek

Microsoft Outlook 15.0-objectbibliotheek		 Microsoft.Office.Interop.Outlook.dll
Microsoft PowerPoint 14.0 Objectbibliotheek

Microsoft PowerPoint 15.0 Objectbibliotheek		 Microsoft.Office.Interop.PowerPoint.dll
Microsoft Project 14.0-objectbibliotheek

Microsoft Project 15.0-objectbibliotheek		 Microsoft.Office.Interop.MSProject.dll
Microsoft Publisher 14.0 Objectbibliotheek

Microsoft Publisher 15.0 Objectbibliotheek		 Microsoft.Office.Interop.Publisher.dll
Microsoft SharePoint Designer 14.0 Web Object Reference Library Microsoft.Office.Interop.SharePointDesigner.dll
Microsoft SharePoint Designer 14.0 Page Object Reference Library Microsoft.Office.Interop.SharePointDesignerPage.dll
Microsoft Smart Tags 2.0 Type Library Opmerking: Infolabels zijn afgeschaft in Excel 2010 en Word 2010. Microsoft.Office.Interop.SmartTag.dll
Microsoft Visio 14.0-typebibliotheek

Microsoft Visio 15.0-typebibliotheek		 Microsoft.Office.Interop.Visio.dll
Microsoft Visio 14.0 Opslaan als webtypebibliotheek

Microsoft Visio 15.0 Opslaan als webtypebibliotheek		 Microsoft.Office.Interop.Visio.SaveAsWeb.dll
Microsoft Visio 14.0 Tekenbesturingstypebibliotheek

Microsoft Visio 15.0-bibliotheek voor tekenbesturingstypen		 Microsoft.Office.Interop.VisOcx.dll
Microsoft Word 14.0 Objectbibliotheek

Microsoft Word 15.0 Objectbibliotheek		 Microsoft.Office.Interop.Word.dll
Microsoft Visual Basic for Applications Extensibility 5.3 Microsoft.Vbe.Interop.dll

Binding-omleidingenassemblies

Wanneer u de Office-PI's installeert en registreert in de globale assemblycache (met Office of door het herdistribueerbare pakket voor de PIA's te installeren), worden de bindingomleidingsassembly's ook alleen geïnstalleerd in de globale assemblycache. Deze assembly's zorgen ervoor dat de juiste versie van de primaire interoperabiliteitsassembly's tijdens runtime wordt geladen.

Wanneer een oplossing die verwijst naar een Office 2010-assembly bijvoorbeeld wordt uitgevoerd op een computer met de Office 2013-versie van dezelfde primaire interop-assembly, geeft de bindingomleidingsassembly de .NET Framework-runtime opdracht om de Office 2013-versie van de primaire interop-assembly te laden.

Zie Procedure: Automatische bindingsomleiding in- en uitschakelen voor meer informatie.

Verwante inhoud

  • Last updated on