Freigeben über

Primäre Interop-Assemblies von Office

Um die Funktionen einer Microsoft Office-Anwendung aus einem Office-Projekt zu nutzen, müssen Sie die primäre Interop-Assembly (PIA) für die Anwendung verwenden. Die PIA ermöglicht verwalteten Code die Interaktion mit dem COM-basierten Objektmodell einer Microsoft Office-Anwendung.

Hinweis

Möchten Sie Lösungen entwickeln, die die Office-Erfahrung auf mehreren Plattformen erweitern? Schauen Sie sich das neue Office-Add-Ins-Modell an. Office-Add-Ins haben im Vergleich zu VSTO-Add-Ins und -Lösungen einen geringen Platzbedarf, und Sie können diese mithilfe nahezu jeder Webprogrammiertechnologie erstellen, z. B. HTML5, JavaScript, CSS3 und XML.

Wenn Sie ein neues Office-Projekt erstellen, fügt Visual Studio Verweise auf die PIAs hinzu, die zum Erstellen des Projekts erforderlich sind. In einigen Szenarien müssen Sie möglicherweise Verweise auf andere PIAs hinzufügen (z. B. können Sie ein Feature von Microsoft Office Word in einem Projekt für Microsoft Office Excel verwenden).

In diesem Artikel werden die folgenden Aspekte der Verwendung der Microsoft Office-PIAs in Office-Projekten beschrieben:

Weitere Informationen zu den primären Interop-Assemblys finden Sie unter Primäre Interop-Assemblys.

Die primären Interop-Assemblys müssen getrennt werden, um Projekte zu erstellen und auszuführen.

Visual Studio verwendet verschiedene Gruppen von PIAs auf dem Entwicklungscomputer. Diese verschiedenen Baugruppen befinden sich an den folgenden Speicherorten:

  • Ein Ordner im Verzeichnis der Programmdateien

    Dieser Satz der Assemblys wird verwendet, wenn Sie Code schreiben und Projekte erstellen. Visual Studio installiert diese Assemblys automatisch.

  • Der globale Assemblycache

    Dieser Satz der Assemblys wird während einiger Entwicklungsaufgaben verwendet, z. B. wenn Sie Projekte ausführen oder debuggen. Visual Studio installiert und registriert diese Assemblys nicht. Sie müssen dies selbst tun.

Primäre Interop-Assemblys im Verzeichnis der Programm-Dateien

Die PIAs werden automatisch zu einem Speicherort im Dateisystem außerhalb des globalen Assemblycaches hinzugefügt, während Sie Visual Studio installieren. Wenn Sie ein neues Projekt erstellen, fügt Visual Studio automatisch Verweise auf diese Kopien der PIAs zu Ihrem Projekt hinzu. Visual Studio verwendet diese Kopien der PIAs anstelle der Assemblys im globalen Assemblycache, um Typverweise beim Entwickeln und Erstellen ihres Projekts aufzulösen.

Wenn verschiedene Versionen der PIAs im globalen Assemblycache registriert sind, können Sie mehrere Entwicklungsprobleme haben. Die hinzugefügten Kopien von PIAs helfen Ihnen, solche Probleme zu vermeiden.

Für Visual Studio 2017 und höher werden diese Kopien der PIAs auf den folgenden freigegebenen Speicherorten auf dem Entwicklungscomputer installiert:

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

  • (oder %ProgramFiles(x86)%\Microsoft Visual Studio\Shared\Visual Studio Tools for Office\PIA\ auf 64-Bit-Betriebssystemen)

Hinweis

Bei älteren Versionen von Visual Studio werden diese PIAs im Ordner "Visual Studio Tools for Office\PIA" unter dem %ProgramFiles% Ordner für diese Version von Visual Studio installiert. Zum Beispiel: %ProgramFiles(x86)%\Microsoft Visual Studio 14.0\Visual Studio Tools for Office\PIA\

Primäre Interop-Assemblys im globalen Assembly-Cache

Um bestimmte Entwicklungsaufgaben auszuführen, müssen die PIAs auf dem Entwicklungscomputer im globalen Assemblycache installiert und registriert werden. Normalerweise werden die PIAs automatisch installiert, wenn Sie Office auf dem Entwicklungscomputer installieren. Weitere Informationen finden Sie unter Konfigurieren eines Computers zum Entwickeln von Office-Lösungen.

Die Office-PIAs sind nicht auf Endbenutzercomputern erforderlich, um Office-Lösungen auszuführen. Weitere Informationen finden Sie unter Entwerfen und Erstellen von Office-Lösungen.

Verwenden von Features mehrerer Microsoft Office-Anwendungen in einem einzelnen Projekt

Jede Office-Projektvorlage in Visual Studio ist für die Arbeit mit einer einzelnen Microsoft Office-Anwendung konzipiert. Um Features in mehreren Microsoft Office-Anwendungen zu verwenden oder Features in einer Anwendung oder Komponente zu verwenden, die nicht über ein Projekt in Visual Studio verfügt, müssen Sie einen Verweis auf die erforderlichen PIAs hinzufügen.

In den meisten Fällen sollten Sie Verweise auf die piAs hinzufügen, die von Visual Studio unter dem %ProgramFiles(x86)%\Microsoft Visual Studio\Shared\Visual Studio Tools for Office\PIA\ Verzeichnis installiert werden. Diese Versionen der Assemblys werden auf der Registerkarte "Framework " des Dialogfelds "Verweis-Manager " angezeigt. Weitere Informationen finden Sie unter Wie man Office-Anwendungen über primäre Interop-Assemblies anvisiert.

Wenn Sie die PIAs im globalen Assemblycache installiert und registriert haben, werden diese Versionen der Assemblys auf der COM-Registerkarte des Dialogfelds "Verweis-Manager" angezeigt. Vermeiden Sie das Hinzufügen von Verweisen auf diese Versionen der Assemblys, da bei der Verwendung einige Entwicklungsprobleme auftreten können. Wenn Sie z. B. unterschiedliche Versionen der PIAs im globalen Assemblycache registriert haben, wird Ihr Projekt automatisch an die Zuletzt registrierte Assemblyversion gebunden, auch wenn Sie auf der COM-Registerkarte des Dialogfelds "Verweis-Manager " eine andere Version der Assembly angeben.

Hinweis

Einige Assemblys werden einem Projekt automatisch hinzugefügt, wenn eine Assembly, die darauf verweist, hinzugefügt wird. Beispielsweise werden Verweise auf die Office.dll Assemblys und Microsoft.Vbe.Interop.dll Assemblys automatisch hinzugefügt, wenn Sie einen Verweis auf die Word-, Excel-, Outlook-, Microsoft Forms- oder Graph-Assemblys hinzufügen.

Primäre Interop assemblies für Microsoft Office-Anwendungen

In der folgenden Tabelle sind die primären Interop-Assemblys aufgeführt, die für Office 2016, Office 2013 und Office 2010 verfügbar sind.


Office-Anwendung oder -Komponente Name der primären Interopassembly
Microsoft Access 14.0-Objektbibliothek

Microsoft Access 15.0-Objektbibliothek		 Microsoft.Office.Interop.Access.dll
Microsoft Office 14.0 Access-Datenbank-Engine-Objektbibliothek

Microsoft Office 15.0 Access-Datenbank-Engine-Objektbibliothek		 Microsoft.Office.Interop.Access.Dao.dll
Microsoft Excel 14.0-Objektbibliothek

Microsoft Excel 15.0-Objektbibliothek		 Microsoft.Office.Interop.Excel.dll
Microsoft Graph 14.0-Objektbibliothek (verwendet von PowerPoint, Access und Word für Diagramme)

Microsoft Graph 15.0-Objektbibliothek		 Microsoft.Office.Interop.Graph.dll
Microsoft InfoPath 2.0-Typbibliothek (nur für InfoPath 2007) Microsoft.Office.Interop.InfoPath.dll
Microsoft InfoPath XML Interop Assembly (nur für InfoPath 2007) Microsoft.Office.Interop.InfoPath.Xml.dll
Microsoft Office 14.0-Objektbibliothek (freigegebene Office-Funktionalität)

Microsoft Office 15.0-Objektbibliothek (freigegebene Office-Funktionen)		 office.dll
Microsoft Office Outlook View Control (kann auf Webseiten und Anwendungen verwendet werden, um auf Ihren Posteingang zuzugreifen) Microsoft.Office.Interop.OutlookViewCtl.dll
Microsoft Outlook 14.0-Objektbibliothek

Microsoft Outlook 15.0-Objektbibliothek		 Microsoft.Office.Interop.Outlook.dll
Microsoft PowerPoint 14.0-Objektbibliothek

Microsoft PowerPoint 15.0-Objektbibliothek		 Microsoft.Office.Interop.PowerPoint.dll
Microsoft Project 14.0-Objektbibliothek

Microsoft Project 15.0-Objektbibliothek		 Microsoft.Office.Interop.MSProject.dll
Microsoft Publisher 14.0-Objektbibliothek

Microsoft Publisher 15.0-Objektbibliothek		 Microsoft.Office.Interop.Publisher.dll
Microsoft SharePoint Designer 14.0-Webobjektreferenzbibliothek Microsoft.Office.Interop.SharePointDesigner.dll
Microsoft SharePoint Designer 14.0 Seitenobjektverweisbibliothek Microsoft.Office.Interop.SharePointDesignerPage.dll
Microsoft Smart Tags 2.0 Typbibliothek Hinweis: Smarttags sind in Excel 2010 und Word 2010 veraltet. Microsoft.Office.Interop.SmartTag.dll
Microsoft Visio 14.0-Typbibliothek

Microsoft Visio 15.0-Typbibliothek		 Microsoft.Office.Interop.Visio.dll
Microsoft Visio 14.0 Als Webtypbibliothek speichern

Microsoft Visio 15.0 Als Webtypbibliothek speichern		 Microsoft.Office.Interop.Visio.SaveAsWeb.dll
Microsoft Visio 14.0 Drawing Control-Typbibliothek

Microsoft Visio 15.0 Drawing Control Type Library		 Microsoft.Office.Interop.VisOcx.dll
Microsoft Word 14.0-Objektbibliothek

Microsoft Word 15.0-Objektbibliothek		 Microsoft.Office.Interop.Word.dll
Erweiterbarkeit von Microsoft Visual Basic für Applikationen 5.3 Microsoft.Vbe.Interop.dll

Binden von Umleitungsassemblys

Wenn Sie die Office-PIAs im globalen Assemblycache installieren und registrieren (entweder mit Office oder durch Installieren des weiterverteilbaren Pakets für die PIAs), werden die Bindungsumleitungsassemblys auch nur im globalen Assemblycache installiert. Diese Assemblys stellen sicher, dass die richtige Version der primären Interopassemblys zur Laufzeit geladen wird.

Wenn beispielsweise eine Lösung, die auf eine Office 2010-Assembly verweist, auf einem Computer mit der Office 2013-Version derselben primären Interopassembly ausgeführt wird, weist die Bindungsumleitungsassembly die .NET Framework-Laufzeit an, die Office 2013-Version der primären Interopassembly zu laden.

Weitere Informationen finden Sie unter Anleitung: Aktivieren und Deaktivieren der automatischen Bindungsweiterleitung.

Verwandte Inhalte

  • Last updated on