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

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.

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.

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.

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.

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.