Übersicht über Visual Studio-Tools für Office-Runtime

  • Artikel

Zum Ausführen von Lösungen, die mithilfe der Microsoft Office-Entwicklertools in Visual Studio erstellt werden, muss die Visual Studio 2010 Tools for Office-Laufzeit auf Endbenutzercomputern installiert sein. Weitere Informationen finden Sie unter How to: Install the Visual Studio-Tools for Office runtime redistributable. Die Visual Studio 2010 Tools for Office-Laufzeit besteht aus zwei Standard Komponenten:

  • 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-Lösungsladeprogramm".

    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 Visual Studio-Tools für Office-Laufzeitinstallationsszenarien.

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

Die Visual Studio 2010-Tools für Office-Laufzeit umfassen Office-Erweiterungen für .NET Framework 3.5, .NET Framework 4 und höher. Projektmappen, die auf die einzelnen Versionen von .NET Framework abzielen, verwenden die entsprechenden Erweiterungen für die jeweilige Version.

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 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 den Office-Erweiterungen finden Sie unter Assemblys in der Visual Studio-Tools für Office-Laufzeit.

Designunterschiede 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 der Visual Studio-Tools für Office-Runtime enthalten waren. Im Gegensatz dazu sind die meisten Typen, die Sie in den Office-Erweiterungen für .NET Framework 4 oder höher verwenden, Schnittstellen. Wenn Sie z. B. auf .NET Framework 4 oder höher abzielen, sind die und Document die Worksheet Typen Schnittstellen anstelle von Klassen.

In den meisten Fällen ist der Code, den Sie in Office-Lösungen schreiben, identisch, unabhängig davon, ob Ihre Lösung auf .NET Framework 3.5 oder .NET Framework 4 ausgerichtet ist. 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 höher.

Schnittstellen in den Office-Erweiterungen für .NET Framework 4 oder höher

Die meisten Schnittstellen in den Office-Erweiterungen für .NET Framework 4 oder höher sind nicht für die Implementierung durch Benutzercode vorgesehen. Die einzigen Schnittstellen, die Sie direkt implementieren können, haben einen Namen, der mit dem Buchstaben Ibeginnt, z. B. ISmartTagExtension.

Alle Schnittstellen, die nicht mit dem Buchstaben beginnen, den ich intern von der Visual Studio 2010 Tools for Office-Laufzeit implementiert habe, und diese Schnittstellen können sich in zukünftigen Versionen ändern. Um Objekte zu erstellen, die diese Schnittstellen implementieren, verwenden Sie im Projekt die vom Globals.Factory-Objekt bereitgestellten Methoden. Verwenden Sie z. B. die SmartTag-Methode, um ein Objekt abzurufen, das die Globals.Factory.CreateSmartTag-Schnittstelle implementiert. Weitere Informationen Globals.Factoryfinden Sie unter globalen Zugriff auf Objekte in Office-Projekten.

Aktivieren von Typgleichheit und eingebetteten Typen in Projekten, die auf .NET Framework 4 oder höher abzielen

Da das Objektmodell der Office-Erweiterungen für .NET Framework 4 oder höher auf Schnittstellen basiert, können Sie das Typgleichgewichtsfeature in Visual C# und Visual Basic in Visual Studio verwenden, um Typinformationen aus der Visual Studio-Tools für Office-Laufzeit in Ihre Lösung einzubetten. Mit diesem Feature können Office-Lösungen und die Visual Studio-Tools für Office-Laufzeit unabhängig voneinander versionieren. Wenn die Projektmappe beispielsweise die Document -Schnittstelle als eingebetteten Typ verwendet und die nächste Version der Laufzeit der Document -Schnittstelle Member hinzufügt, funktioniert die Projektmappe immer noch mit der nächsten Version der Laufzeit. Wenn die Projektmappe die Document -Schnittstelle nicht als eingebetteten Typ verwendet, funktioniert die Projektmappe nicht mehr mit der nächsten Version der Laufzeit.

Standardmäßig ist das Feature "Äquivalenztyp" nicht aktiviert, wenn Sie ein Office-Projekt erstellen, das auf .NET Framework 4 oder höher ausgerichtet ist. Wenn Sie diese Funktion aktivieren möchten, legen Sie die Eigenschaft Interoptypen einbetten von einem der folgenden Assemblyverweise im Projekt auf Truefest:

  • 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 Laden der Office-Lösung

Visual Studio-Tools für Office-Laufzeit schließt mehrere nicht verwaltete DLLs ein, die Office-Anwendungen verwenden, um die Laufzeit sowie 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 dazu, wie diese Komponenten während des Ladevorgangs verwendet werden, finden Sie unter Architektur von Anpassungen auf Dokumentebene und Architektur von VSTO-Add-Ins.

vstoee.dll

Wenn ein Benutzer eine Anpassung auf Dokumentebene öffnet oder ein VSTO-Add-In startet, ruft die Office-App lizenzierung VSTOEE.dll auf, um die zum Laden der Visual Studio-Tools für Office-Laufzeit erforderlichen Aufgaben auszuführen.

VSTOEE.dll stellt sicher, dass die richtige Version der Visual Studio-Tools für Die Office-Laufzeit für die Lösung und die installierte Version von Office geladen wird. Obwohl mehrere Versionen der Visual Studio-Tools für Office-Laufzeit auf demselben Computer installiert werden können, wird jeweils nur eine Instanz von VSTOEE.dll installiert. Dies ist die VSTOEE.dll , die in der neuesten Version der auf dem Computer installierten Laufzeit enthalten war. Weitere Informationen zu den verschiedenen Versionen der Visual Studio-Tools für Office-Laufzeit, die für andere Lösungen verwendet werden können, finden Sie unter Ausführen von Lösungen in verschiedenen 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 die meiste Arbeit aus, die zum Laden der Lösungsassembly erforderlich ist. VSTOLoader.dll führt mehrere Dinge 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 verschiedene Dinge aus, die für VSTO-Add-Ins spezifisch sind:

  • Es implementiert die IDTExtensibility2 -Schnittstelle. IDTExtensibility2 ist eine COM-Schnittstelle, die alle VSTO-Add-Ins für Microsoft Office-Anwendungen implementieren müssen. Diese Schnittstelle definiert Methoden, die die Anwendung aufruft, um mit dem VSTO-Add-In zu kommunizieren.

  • Es implementiert die IManagedAddin-Schnittstelle. Diese Schnittstelle wird von Office-App lizenzen verwendet, um das Laden von VSTO-Add-Ins zu unterstützen. 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 auszuführen. Die folgende Tabelle zeigt, welche Version der Laufzeit für jede Kombination von Windows und Office 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 installieren, wird die erforderliche Version der Visual Studio-Tools für Die Office-Laufzeit zusammen mit Office installiert. Wenn Sie beispielsweise die 64-Bit-Edition von Office auf einer 64-Bit-Version von Windows installieren, wird auch die 64-Bit-Version der Visual Studio-Tools für Office-Laufzeit installiert. Weitere Informationen zum Installieren der Visual Studio-Tools für Office-Runtime mit Office finden Sie unter Visual Studio-Tools für Office-Laufzeitinstallationsszenarien.

Mit der 64-Bit-Version von Office können auch Office-Projektmappen ausgeführt werden, die mit Projektvorlagen für 2007 Microsoft Office System in Visual Studio 2008 erstellt wurden. 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 verschiedenen Versionen von Microsoft Office.

Reparieren der Visual Studio 2010 Tools for 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 Ändernklicken, ist keine Option zum Reparieren der Laufzeit verfügbar.

Zugehöriger Inhalt