Freigeben über


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

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 So installieren Sie das Visual Studio Tools for Office-Runtime-Redistributable. Die Visual Studio 2010 Tools for Office-Laufzeit besteht aus zwei Hauptkomponenten:

  • Die Office-Erweiterungen für .NET Framework. Diese Komponenten sind verwaltete Assemblys, die die Kommunikationsschicht zwischen Ihrer Lösung und der Microsoft Office-Anwendung bereitstellen. Weitere Informationen finden Sie unter "Grundlegendes zu den Office-Erweiterungen für .NET Framework".

  • Das Office-Lösungsladeprogramm. Diese Komponente ist eine Reihe nicht verwalteter DLLs, die von Office-Anwendungen zum Laden der Laufzeitumgebung und Ihrer Lösungen verwendet werden. Weitere Informationen finden Sie unter "Grundlegendes zum Office-Lösungsladeprogramm".

    Die Laufzeit kann auf verschiedene Weise installiert werden. Je nach Konfiguration des Computers werden beim Installieren der Laufzeit unterschiedliche Laufzeitkomponenten installiert. Weitere Informationen finden Sie unter Visual Studio Tools for 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. Lösungen, die auf jede Version von .NET Framework abzielen, verwenden die entsprechenden Erweiterungen für diese Version.

Diese Erweiterungen bestehen aus Assemblys, die Ihre Lösungen zum Automatisieren und Erweitern von Office-Anwendungen verwenden. Wenn Sie ein Office-Projekt erstellen, fügt Visual Studio automatisch Verweise auf die Assemblys hinzu, die für den Projekttyp und das .NET Framework-Ziel des Projekts verwendet werden. Weitere Informationen zu den Assemblys in den Office-Erweiterungen finden Sie unter Assemblys in der Visual Studio Tools for Office Runtime.

Designunterschiede in den Office-Erweiterungen

Die meisten Typen, die Sie in den Office-Erweiterungen für .NET Framework 3.5 verwenden, sind Klassen. Dies sind dieselben Klassen, die in früheren Versionen der Visual Studio Tools for 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 das .NET Framework 4 oder höher abzielen, sind die Typen Worksheet und Document 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 Features erfordern jedoch unterschiedliche Code, wenn Sie auf unterschiedliche 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 Namen, die mit dem Buchstaben I beginnen, wie z. B. ISmartTagExtension.

Alle Schnittstellen, die nicht mit dem Buchstaben I beginnen, werden intern von der Visual Studio 2010 Tools for Office-Laufzeitumgebung implementiert, und diese Schnittstellen können sich in zukünftigen Versionen ändern. Verwenden Sie zum Erstellen von Objekten, die diese Schnittstellen implementieren, die von dem Globals.Factory-Objekt in Ihrem Projekt bereitgestellten Methoden. Um beispielsweise ein Objekt abzurufen, das die SmartTag Schnittstelle implementiert, verwenden Sie die Globals.Factory.CreateSmartTag Methode. 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 den 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 aktualisiert werden. Wenn Ihre Lösung beispielsweise die Document Schnittstelle als eingebetteten Typ verwendet und die nächste Version der Laufzeit Member Document zur Schnittstelle hinzufügt, funktioniert Ihre Lösung weiterhin mit der nächsten Version der Laufzeit. Wenn Ihre Lösung die Document Schnittstelle nicht als eingebetteten Typ verwendet, funktioniert ihre Lösung 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 dieses Feature aktivieren möchten, legen Sie die Eigenschaft "Interoperabilitätstypen einbetten" eines der folgenden Assemblyverweise in Ihrem 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 alle Laufzeittypen, die vom Projekt verwendet werden, beim Erstellen des Projekts in die Lösungsassembly eingebettet. Diese eingebetteten Typinformationen anstelle der Typinformationen in den referenzierten Assemblys werden zur Laufzeit von der Lösung verwendet.

Grundlegendes zum Laden der Office-Lösung

Die Visual Studio Tools für die Office-Runtime enthalten mehrere nicht verwaltete (unmanaged) DLLs, die Office-Anwendungen nutzen, um die Runtime und Office-Lösungen zu laden. Obwohl Sie niemals direkt mit diesen DLLs arbeiten müssen, kann das Verständnis der Zwecke dieser DLLs Ihnen helfen, die Architektur von Office-Lösungen 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-Anwendung 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 for 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 for 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 Aktionen aus:

  • Sie erstellt eine Anwendungsdomäne für jede Lösungsassembly.

  • Es führt eine Reihe von Sicherheitsprüfungen aus, um zu überprüfen, ob die Lösungsassembly über die Berechtigung zum Ausführen verfügt.

  • Sie lädt die Version der Office-Erweiterungen für .NET Framework, die von der Lösung benötigt wird.

    VSTOLoader.dll führt auch verschiedene Aktionen aus, die für VSTO-Add-Ins spezifisch sind:

  • Sie 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-Anwendungen verwendet, um VSTO-Add-Ins zu laden. 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 für die Office-Laufzeitumgebung. Diese Versionen der Laufzeit werden verwendet, um Lösungen 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 für Office Runtime
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 for 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 zu den Installationsszenarien der Visual Studio Tools for Office Runtime mit Office finden Sie in Visual Studio Tools für Office Runtime-Installationsszenarien.

Die 64-Bit-Version von Office kann auch Office-Lösungen ausführen, die mithilfe von Projektvorlagen für das 2007 Microsoft Office System in Visual Studio 2008 erstellt wurden. Sie kann jedoch keine Office-Lösungen ausführen, die mit Projektvorlagen für Microsoft Office 2003 in Visual Studio 2008 oder mit Visual Studio 2005 erstellten Office-Lösungen erstellt wurden. Weitere Informationen finden Sie unter Ausführen von Lösungen in verschiedenen Versionen von Microsoft Office.

Reparatur von Visual Studio 2010 Tools for Office Runtime

Wenn Sie die Laufzeit reparieren müssen, öffnen Sie "Programme und Features ", "Programme hinzufügen oder entfernen " in der Systemsteuerung, wählen Sie "Microsoft Visual Studio 2010 Tools for Office Runtime " in der Liste der Programme aus, und klicken Sie dann auf "Deinstallieren". Mit dem ausgeführten Setupprogramm können Sie die Laufzeit reparieren. Wenn Sie auf "Ändern" klicken, erhalten Sie keine Option zum Reparieren der Laufzeit.