Übersicht über die Visual Studio Tools for Office-Laufzeit

Artikel
03/22/2013

Um Projektmappen ausgeführt werden mit den Microsoft Office-Entwicklertools in Visual Studio 2012 verwendet, müssen die Visual Studio 2010 Tools for Office Runtime auf Endbenutzercomputern installiert werden.Die Visual Studio 2010 Tools for Office Runtime besteht aus zwei Hauptkomponenten:

Den Office-Erweiterungen für .NET Framework.Diese Komponenten sind verwaltete Assemblys, die die Kommunikationsebene zwischen der Projektmappe und der Microsoft Office-Anwendung bereitstellen.Weitere Informationen finden Sie unter Grundlegendes zu den Office-Erweiterungen für .NET Framework.
Dem Office-Projektmappenladeprogramm.Bei dieser Komponente handelt es sich um einen Satz nicht verwalteter DLLs, die Office-Anwendungen verwenden, um die Laufzeit und Projektmappen zu laden.Weitere Informationen finden Sie unter Grundlegendes zum Office-Projektmappenladeprogramm.

Die Laufzeit kann auf unterschiedliche Weise installiert werden.In Abhängigkeit von der Konfiguration des Computers werden unterschiedliche Laufzeitkomponenten installiert, wenn Sie die Laufzeit installieren.Weitere Informationen finden Sie unter Laufzeitinstallationsszenarios für Visual Studio Tools for Office.

Grundlegendes zu den Office-Erweiterungen für .NET Framework

Die Visual Studio 2010 Tools for Office-Laufzeit schließt Office-Erweiterungen für .NET Framework 3.5, .NET Framework 4 und .NET Framework 4.5 ein.Projektmappen, die jede Version der .NET Framework-Verwendung die entsprechenden Erweiterungen für diese Version abzielen.

Diese Erweiterungen bestehen aus Assemblys, die von den Projektmappen verwendet werden, um Office-Anwendungen zu automatisieren und zu erweitern.Wenn Sie ein Office-Projekt erstellen, fügt Visual Studio Verweise automatisch Verweise auf die Assemblys hinzu, die für den Projekttyp und das Ziel-.NET Framework des Projekts verwendet werden.Weitere Informationen zu den Assemblys in Office-Erweiterungen finden Sie unter Assemblys in Visual Studio Tools for Office Runtime.

Entwurfsunterschiede in den Office-Erweiterungen

Bei den meisten Typen, die Sie in Office-Erweiterungen für .NET Framework 3.5 verwenden, handelt es sich um Klassen.Dies sind die gleichen Klassen, die in früheren Versionen Visual Studio-Tools für Office-Laufzeit enthalten waren. Im Gegensatz dazu sind die meisten Typen, die Sie in den Office-Erweiterungen für .NET Framework 4 und .NET Framework 4.5 verwenden, Schnittstellen.Wenn Sie beispielsweise .NET Framework 4 oder .NET Framework 4.5 auf abzielen, sind die Microsoft.Office.Tools.Excel.Worksheet und Microsoft.Office.Tools.Word.Document-Typen Schnittstellen statt Klassen.

In den meisten Fällen ist der Code, den Sie in Office-Projektmappen schreiben, derselbe, unabhängig davon, ob die Projektmappe auf .NET Framework 3.5 oder .NET Framework 4 abzielt.Bestimmte Funktionen erfordern jedoch anderen Code, wenn Sie auf andere Versionen von .NET Framework abzielen.Weitere Informationen finden Sie unter Migrieren von Office-Lösungen zu .NET Framework 4 oder .NET Framework 4.5.

Schnittstellen in den Office-Erweiterungen für .NET Framework 4 und .NET Framework 4.5

Die meisten der Schnittstellen in den Office-Erweiterungen für .NET Framework 4 und des .NET Framework 4.5 werden nicht vorgesehen, durch Benutzercode implementiert werden.Die einzigen Schnittstellen, die Sie direkt implementieren können, haben einen Namen, der mit dem Buchstaben I beginnt, z. B. ISmartTagExtension.

Alle Schnittstellen, die nicht mit dem Buchstaben I beginnen, werden intern von der implementiert Visual Studio 2010 Tools for Office Runtime und diese Schnittstellen könnten sich in zukünftigen Versionen.Um Objekte zu erstellen, die diese Schnittstellen implementieren, verwenden Sie im Projekt die vom Globals.Factory-Objekt bereitgestellten Methoden.Verwenden Sie beispielsweise die Globals.Factory.CreateSmartTag-Methode, um ein Objekt abzurufen, das die SmartTag-Schnittstelle implementiert.Weitere Informationen zu Globals.Factory finden Sie unter Globaler Zugriff auf Objekte in Office-Projekten.

Aktivieren von Typäquivalenz und eingebettet, Typen in Projekten, die auf .NET Framework 4 und .NET Framework 4.5 abzielen

Da das Objektmodell der Office-Erweiterungen für .NET Framework 4 und .NET Framework 4.5 auf Grundlage Schnittstellen sind, können Sie die Typäquivalenzfunktion in Visual C# und in Visual Basic in Visual Studio 2012 verwenden, Typinformationen von Visual Studio-Tools für Office-Laufzeit in die Projektmappe einzubetten. Diese Funktion ermöglicht Office-Projektmappen und Visual Studio-Tools für Office-Laufzeit zur Version unabhängig voneinander.Wenn die Projektmappe beispielsweise die Microsoft.Office.Tools.Word.Document-Schnittstelle als eingebetteten Typ verwendet und die nächste Version der Laufzeit der Microsoft.Office.Tools.Word.Document-Schnittstelle Member hinzufügt, funktioniert die Projektmappe immer noch mit der nächsten Version der Laufzeit.Wenn die Projektmappe die Microsoft.Office.Tools.Word.Document-Schnittstelle nicht als eingebetteten Typ verwendet, funktioniert die Projektmappe nicht mehr mit der nächsten Version der Laufzeit.

Standardmäßig wird die Typäquivalenzfunktion nicht aktiviert, wenn Sie ein Office-Projekt mit der Zielversion .NET Framework 4 oder .NET Framework 4.5 erstellen.Wenn Sie diese Funktion aktivieren möchten, legen Sie die Eigenschaft Interoptypen einbetten von einem der folgenden Assemblyverweise im Projekt auf True fest:

Microsoft.Office.Tools.dll
Microsoft.Office.Tools.Common.dll
Microsoft.Office.Tools.Excel.dll
Microsoft.Office.Tools.Outlook.dll
Microsoft.Office.Tools.Word.dll

Nachdem Sie diese Änderung vorgenommen haben, werden Typinformationen für alle vom Projekt verwendeten Laufzeittypen in die Projektmappenassembly eingebettet, wenn Sie das Projekt erstellen.Diese eingebetteten Typinformationen werden anstelle der Typinformationen in den Assemblys, auf die verwiesen wird, von der Projektmappe zur Laufzeit verwendet.

Grundlegendes zum Office-Projektmappenladeprogramm

Visual Studio Tools for Office-Laufzeit enthält mehrere nicht verwaltete DLL ein, die Office-Anwendungen verwenden, um die Laufzeit und die Office-Projektmappen zu laden.Obwohl Sie in der Regel nie direkt mit diesen DLLs arbeiten müssen, können Kenntnisse über ihren Zweck Ihnen dabei helfen, die Architektur der Office-Projektmappen besser zu verstehen.

Informationen darüber, wie diese Komponenten während des Ladevorgangs verwendet werden, finden Sie unter Architektur von Anpassungen auf Dokumentebene und unter Architektur von Add-Ins auf Anwendungsebene

VSTOEE.dll

Wenn ein Benutzer eine Anpassung auf Dokumentebene öffnet oder ein Add-In startet, ruft die Office-Anwendung VSTOEE.dll auf, um die Aufgaben auszuführen, die erforderlich sind, um die Visual Studio-Tools für Office-Laufzeit zu laden.

VSTOEE.dll stellt sicher, dass die richtige Version der Visual Studio-Tools für Office-Laufzeit für die Projektmappe und die installierte Version von Office geladen wird.Obwohl mehrere Versionen der Visual Studio-Tools für Office-Laufzeit-Laufzeit auf demselben Computer installiert werden können, wird immer nur eine Instanz der Datei "VSTOEE.dll" installiert.Dabei handelt es sich um die Datei VSTOEE.dll, die in der neuesten Version der Laufzeit enthalten war, die auf dem Computer installiert wurde.Weitere Informationen zu den unterschiedlichen Versionen der Visual Studio-Tools für Office-Laufzeit, die für andere Projektmappen verwendet werden kann, finden Sie unter Ausführen von Lösungen in unterschiedlichen Versionen von Microsoft Office.

VSTOLoader.dll

Nachdem VSTOEE.dll die entsprechende Version der Visual Studio-Tools für Office-Laufzeit geladen hat, führt VSTOLoader.dll den Großteil der Arbeit aus, die zum Laden der Projektmappenassembly erforderlich ist.VSTOLoader.dll führt mehrere Aufgaben aus:

Es erstellt eine Anwendungsdomäne für jede Projektmappenassembly.
Es führt einen Satz von Sicherheitsüberprüfungen aus, um zu überprüfen, ob die Projektassembly über die Berechtigung zum Ausführen verfügt.
Es lädt die Version der Office-Erweiterungen für das .NET Framework, das für die Projektmappe erforderlich ist.

VSTOLoader.dll führt auch mehrere Aufgaben aus, die für Add-Ins spezifisch sind:

Es implementiert die IDTExtensibility2-Schnittstelle.IDTExtensibility2 ist eine COM-Schnittstelle, die alle Add-Ins für Microsoft Office-Anwendungen implementieren müssen.Diese Schnittstelle definiert Methoden, die die Anwendung aufruft, um mit dem Add-In zu kommunizieren.
Es implementiert die IManagedAddin-Schnittstelle.Diese Schnittstelle wird von Office-Anwendungen beim Laden von Add-Ins auf Anwendungsebene verwendet.Weitere Informationen finden Sie unter IManagedAddin-Schnittstelle.

Grundlegendes zu den 32-Bit- und 64-Bit-Versionen der Laufzeit

Es gibt separate 64-Bit- und 32-Bit-Versionen der Visual Studio 2010 Tools for Office-Laufzeit.Diese Versionen der Laufzeit werden verwendet, um Projektmappen in 64-Bit- und 32-Bit-Editionen von Office 2013 und von Office 2010 auszuführen.Die folgende Tabelle zeigt, welche Version der Laufzeit für jede Kombination von Windows und Office 2013 oder Office 2010 erforderlich ist.

Edition von Windows	Edition von Microsoft Office	Erforderliche Version der Visual Studio Tools for Office-Laufzeit.
32 Bit	32 Bit	32 Bit
64 Bit	32 Bit	64 Bit
64 Bit	64 Bit	64 Bit

Wenn Sie Office 2013 oder Office 2010 installieren, wird die erforderliche Version Visual Studio-Tools für Office-Laufzeit zusammen mit Office installiert.Wenn Sie beispielsweise die 64-Bit-Edition von Office 2013 oder von Office 2010 auf einer 64-Bit-Version von Windows installieren, wird die 64-Bit-Version Visual Studio-Tools für Office-Laufzeit auch installiert.Weitere Informationen zum Installieren Visual Studio-Tools für Office-Laufzeit mit Office 2013 oder Office 2010, finden Sie unter Laufzeitinstallationsszenarios für Visual Studio Tools for Office.

Die 64-Bit-Version von Office 2013 oder von Office 2010 kann Office-Projektmappen ausführen, die erstellt wurden, indem Projektvorlagen für das 2007 Microsoft Office System in Visual Studio 2008 verwendet.Es können jedoch keine Office-Projektmappen ausgeführt werden, die mit Projektvorlagen für Microsoft Office 2003 in Visual Studio 2008 erstellt wurden, oder Office-Projektmappen, die mit Visual Studio 2005 erstellt wurden.Weitere Informationen finden Sie unter Ausführen von Lösungen in unterschiedlichen Versionen von Microsoft Office.

Reparieren der Visual Studio 2010-Tools für Office-Laufzeit

Wenn Sie die Laufzeit reparieren müssen, öffnen Sie in der Systemsteuerung Programme und Funktionen oder Software, wählen Sie in der Liste der Programme die Microsoft Visual Studio 2010-Tools für Office-Laufzeit aus, und klicken Sie dann auf Deinstallieren.Das ausgeführte Setupprogramm ermöglicht es Ihnen, die Laufzeit zu reparieren.Wenn Sie auf Ändern klicken, ist keine Option zum Reparieren der Laufzeit verfügbar.

Siehe auch

Freigeben über