Freigeben über

Primäre Interopassemblys in Office

  • Artikel

Aktualisiert: November 2007

Zur Verwendung der Features einer Microsoft Office-Anwendung in einem Visual Studio Tools for Office-Projekt müssen Sie die primäre Interopassembly für diese Anwendung verwenden. Mithilfe der primären Interopassembly kann verwalteter Code mit dem COM-basierten Objektmodell einer Office-Anwendung interagieren.

Wenn Sie ein neues Visual Studio Tools for Office-Projekt erstellen, fügt Visual Studio Verweise auf die primären Interopassemblys hinzu, die zum Erstellen des Projekts erforderlich sind. In einigen Szenarien müssen Sie Verweise auf zusätzliche primäre Interopassemblys hinzufügen (beispielsweise wenn Sie ein Feature von Microsoft Office Word in einem Projekt für Microsoft Office Excel verwenden möchten).

In diesem Thema werden die folgenden Aspekte der Verwendung von primären Interopassemblys in Microsoft Office beschrieben:

  • Separate primäre Interopassemblys zum Erstellen und Ausführen von Projekten

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

  • Primäre Interopassemblys für Microsoft Office 2003

  • Primäre Interopassemblys für das 2007 Microsoft Office System

Weitere Informationen über primäre Interopassemblys finden Sie unter Primäre Interop-Assemblys.

Separate primäre Interopassemblys zum Erstellen und Ausführen von Projekten

Visual Studio Tools for Office verwendet unterschiedliche Sätze von primären Interopassemblys auf dem Entwicklungscomputer. Diese unterschiedlichen Assemblysätze befinden sich an den folgenden Speicherorten:

  • In einem Ordner im Verzeichnis Programme.

    Diese Kopien der Assemblys werden verwendet, wenn Sie Code schreiben und Projekte erstellen. Sie werden von Visual Studio Tools for Office automatisch installiert.

  • Im globalen Assemblycache.

    Diese Kopien der Assemblys werden verwendet, wenn Sie Projekte ausführen oder debuggen. Sie werden von Visual Studio Tools for Office nicht installiert und registriert. Installation und Registrierung müssen Sie selbst vornehmen.

Primäre Interopassemblys im Verzeichnis "Programme"

Bei der Installation von Visual Studio Tools for Office werden die primären Interopassemblys automatisch an einem Speicherort im Dateisystem außerhalb des globalen Assemblycaches installiert. Wenn Sie ein neues Projekt erstellen, fügt Visual Studio Tools for Office dem Projekt automatisch Verweise auf diese Kopien der primären Interopassemblys hinzu. Visual Studio Tools for Office verwendet diese Kopien der primären Interopassemblys anstelle der Assemblys im globalen Assemblycache, um Typverweise beim Entwickeln und Erstellen des Projekts aufzulösen. 

Mithilfe dieser Kopien der primären Interopassemblys kann Visual Studio Tools for Office möglicherweise Entwicklungsprobleme vermeiden, die auftreten können, wenn die 2003-Version und die 2007-Version der primären Interopassemblys von Office im globalen Assemblycache registriert sind.

Visual Studio Tools for Office installiert diese Kopien der primären Interopassemblys an den folgenden Speicherorten auf dem Entwicklungscomputer:

  • %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

Installieren von primären Interopassemblys im globalen Assemblycache

Zum Ausführen der meisten Entwicklungsaufgaben müssen Sie die primären Interopassemblys im globalen Assemblycache installieren und registrieren. Führen Sie dazu eine vollständige Installation von Microsoft Office aus, oder installieren Sie das verteilbare Paket für die primären Interopassemblys. Weitere Informationen finden Sie unter Gewusst wie: Installieren von primären Interopassemblys für Office.

Die primären Interopassemblys müssen im globalen Assemblycache installiert und registriert sein, damit Sie die folgenden Entwicklungsaufgaben ausführen können:

  • Erstellen eines Projekts für Anpassungen auf Dokumentebene.

  • Ausführen oder Debuggen eines beliebigen Visual Studio Tools for Office-Projekts.

Auf Endbenutzercomputern müssen ebenfalls die primären Interopassemblys im globalen Assemblycache installiert und registriert sein, um Visual Studio Tools for Office-Projektmappen ausführen zu können.

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

Jede Projektvorlage in Visual Studio Tools for Office wird entworfen, um mit einer einzelnen Microsoft Office-Anwendung zu arbeiten. Um Features in mehreren Microsoft Office-Anwendungen oder in einer Anwendung bzw. Komponente zu verwenden, die kein Projekt in Visual Studio Tools for Office besitzt, müssen Sie einen Verweis auf die erforderlichen primären Interopassemblys hinzufügen. 

In den meisten Fällen müssen Sie Verweise auf die primären Interopassemblys hinzufügen, die von Visual Studio Tools for Office im Verzeichnis %ProgramFiles% installiert wurden. Diese Versionen der Assemblys werden im Dialogfeld Verweis hinzufügen auf der Registerkarte .NET angezeigt. Weitere Informationen finden Sie unter Verweisen auf Office-Anwendungen durch primäre Interopassemblys.

Wenn Sie die primären Interopassemblys im globalen Assemblycache installiert und registriert haben, werden diese Versionen im Dialogfeld Verweis hinzufügen auf der Registerkarte COM angezeigt. Vermeiden Sie es, Verweise auf diese Versionen hinzuzufügen, da sonst bei ihrer Verwendung Entwicklungsprobleme auftreten können. Wenn z. B. die 2003-Version und die 2007-Version der primären Interopassemblys im globalen Assemblycache installiert sind, wird das Projekt automatisch an die Version der Assembly gebunden, die zuletzt registriert wurde - auch dann, wenn Sie im Dialogfeld Verweis hinzufügen auf der Registerkarte COM eine andere Version angegeben haben.

Hinweis:

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

Primäre Interopassemblys für Microsoft Office 2003

In der folgenden Tabelle sind die primären Interopassemblys aufgelistet, die für Microsoft Office 2003 zur Verfügung stehen.

Office-Anwendung oder Office-Komponente

Name der primären Interopassembly

Microsoft Access 11.0-Objektbibliothek

Microsoft.Office.Interop.Access.dll

Microsoft Excel 11.0-Objektbibliothek

Microsoft.Office.Interop.Excel.dll

Microsoft FrontPage 6.0-Webobjekt-Verweisbibliothek

Microsoft.Office.Interop.Frontpage.dll

Microsoft FrontPage 6.0-Seitenobjekt-Verweisbibliothek

Microsoft.Office.Interop.Frontpageeditor.dll

Microsoft Graph 11.0-Objektbibliothek (wird von PowerPoint, Access und Word für Diagramme verwendet)

Microsoft.Office.Interop.Graph.dll

Microsoft Outlook 11.0-Objektbibliothek

Microsoft.Office.Interop.Outlook.dll

Microsoft Outlook-Ansichtensteuerelement (kann auf Webseiten und in Anwendungen für den Zugriff auf den Posteingang verwendet werden)

Microsoft.Office.Interop.OutlookViewCtl.dll

Microsoft Office Web Components 11.0 (Arbeitsblätter, Diagramme und PivotTables für Webseiten)

Microsoft.Office.Interop.owc11.dll

Microsoft PowerPoint 11.0-Objektbibliothek

Microsoft.Office.Interop.PowerPoint.dll

Microsoft Project 11.0-Objektbibliothek

Microsoft.Office.Interop.MSProject.dll

Microsoft Publisher 11.0-Objektbibliothek

Microsoft.Office.Interop.Publisher.dll

Microsoft Smart Tags 2.0-Typbibliothek

Microsoft.Office.Interop.SmartTag.dll

Microsoft Word 11.0-Objektbibliothek

Microsoft.Office.Interop.Word.dll

Microsoft Visual Basic for Applications Erweiterung 5.3

Microsoft.Vbe.Interop.dll

Microsoft Forms 2.0-Objektbibliothek (programmierbare Steuerelemente, die in Anwendungen verwendet werden können)

Microsoft.Vbe.Interop.Forms.dll

Microsoft Office 11.0-Objektbibliothek (gemeinsam genutzte Office-Funktionen)

office.dll

Primäre Interopassemblys für 2007 Microsoft Office System

In der folgenden Tabelle sind die primären Interopassemblys aufgelistet, die für 2007 Microsoft Office System zur Verfügung stehen.

Office-Anwendung oder Office-Komponente

Name der primären Interopassembly

Microsoft Access 12.0-Objektbibliothek

Microsoft.Office.Interop.Access.dll

Objektbibliothek des Microsoft Office 2007 Access-Datenbankmoduls

Microsoft.Office.Interop.Access.Dao.dll

Microsoft Excel 12.0-Objektbibliothek

Microsoft.Office.Interop.Excel.dll

Microsoft Graph 12.0-Objektbibliothek (wird von PowerPoint, Access und Word für Diagramme verwendet)

Microsoft.Office.Interop.Graph.dll

Microsoft InfoPath 2.0-Typbibliothek

Microsoft.Office.Interop.InfoPath.dll

Microsoft InfoPath XML-Interopassembly

Microsoft.Office.Interop.InfoPath.Xml.dll

Microsoft Outlook 12.0-Objektbibliothek

Microsoft.Office.Interop.Outlook.dll

Microsoft Office Outlook-Ansichtensteuerelement (kann auf Webseiten und in Anwendungen für den Zugriff auf den Posteingang verwendet werden)

Microsoft.Office.Interop.OutlookViewCtl.dll

Microsoft PowerPoint 12.0-Objektbibliothek

Microsoft.Office.Interop.PowerPoint.dll

Microsoft Project 12.0-Objektbibliothek

Microsoft.Office.Interop.MSProject.dll

Microsoft Publisher 12.0-Objektbibliothek

Microsoft.Office.Interop.Publisher.dll

Microsoft SharePointDesigner 12.0-Webobjekt-Verweisbibliothek

Microsoft.Office.Interop.SharePointDesigner.dll

Microsoft SharePointDesigner 12.0-Seitenobjekt-Verweisbibliothek

Microsoft.Office.Interop.SharePointDesignerPage.dll

Microsoft Smart Tags 2.0-Typbibliothek

Microsoft.Office.Interop.SmartTag.dll

Microsoft Visio 12.0-Typbibliothek

Microsoft.Office.Interop.Visio.dll

Microsoft Visio 12.0-Typbibliothek für "Speichern als Web"

Microsoft.Office.Interop.Visio.SaveAsWeb.dll

Microsoft Visio 12.0-Typbibliothek für Zeichnungssteuerelemente

Microsoft.Office.Interop.VisOcx.dll

Microsoft Word 12.0-Objektbibliothek

Microsoft.Office.Interop.Word.dll

Microsoft Visual Basic for Applications Erweiterung 5.3

Microsoft.Vbe.Interop.dll

Microsoft Office 12.0-Objektbibliothek (gemeinsam genutzte Office-Funktionen)

office.dll

Umleitung der Assemblybindung für Microsoft Access-Objektbibliothek

Policy.11.0.Microsoft.Office.Interop.Access.dll

Umleitung der Assemblybindung für Microsoft Excel-Objektbibliothek

Policy.11.0.Microsoft.Office.Interop.Excel.dll

Umleitung der Assemblybindung für Microsoft Graph-Objektbibliothek

Policy.11.0.Microsoft.Office.Interop.Graph.dll

Umleitung der Assemblybindung für Microsoft InfoPath-Typbibliothek

Policy.11.0.Microsoft.Office.Interop.InfoPath.dll

Umleitung der Assemblybindung für Microsoft InfoPath-XML-Interopassembly

Policy.11.0.Microsoft.Office.Interop.InfoPath.Xml.dll

Umleitung der Assemblybindung für Microsoft Outlook-Objektbibliothek

Policy.11.0.Microsoft.Office.Interop.Outlook.dll

Umleitung der Assemblybindung für Microsoft Outlook-Ansichtensteuerelement

Policy.11.0.Microsoft.Office.Interop.OutlookViewCtl.dll

Umleitung der Assemblybindung für Microsoft PowerPoint-Objektbibliothek

Policy.11.0.Microsoft.Office.Interop.PowerPoint.dll

Umleitung der Assemblybindung für Microsoft Project-Objektbibliothek

Policy.11.0.Microsoft.Office.Interop.MSProject.dll

Umleitung der Assemblybindung für Microsoft Publisher-Objektbibliothek

Policy.11.0.Microsoft.Office.Interop.Publisher.dll

Umleitung der Assemblybindung für Microsoft Smart Tags-Typbibliothek

Policy.11.0.Microsoft.Office.Interop.SmartTag.dll

Microsoft Visio-Typbibliothek

Policy.11.0.Microsoft.Office.Interop.Visio.dll

Umleitung der Assemblybindung für Microsoft Visio-Typbibliothek für "Speichern als Web"

Policy.11.0.Microsoft.Office.Interop.Visio.SaveAsWeb.dll

Umleitung der Assemblybindung für Microsoft Visio-Typbibliothek für Zeichnungssteuerelemente

Policy.11.0.Microsoft.Office.Interop.VisOcx.dll

Umleitung der Assemblybindung für Microsoft Word-Objektbibliothek

Policy.11.0.Microsoft.Office.Interop.Word.dll

Umleitung der Assemblybindung für Microsoft Visual Basic for Applications Erweiterung 5.3

Policy.11.0.Microsoft.Vbe.Interop.dll

Umleitung der Assemblybindung für Microsoft Office-Objektbibliothek

Policy.11.0.office.dll
Hinweis:

Die Umleitung der Assemblybindung gewährleistet, dass die 2007 Microsoft Office-Version der primären Interopassemblys zur Laufzeit geladen wird. Wenn eine Visual Studio Tools for Office-Projektmappe, die auf eine primäre Interopassembly für Microsoft Office 2003 verweist, auf einem Computer mit der 2007 Microsoft Office-Version derselben primären Interopassembly ausgeführt wird, weist die Umleitung der Assemblybindung die .NET Framework-Laufzeit an, die 2007 Microsoft Office-Version der primären Interopassembly zu laden. Weitere Informationen hierzu finden Sie unter Umleitung der Assemblybindung.

Siehe auch

Aufgaben

Verweisen auf Office-Anwendungen durch primäre Interopassemblys

Weitere Ressourcen

Allgemeine Referenz (Visual Studio Tools for Office)