Primäre Interopassemblys in Office

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)