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

Artikel
04/28/2010

Aktualisiert: November 2007

Um Projektmappen auszuführen, die mit Visual Studio Tools for Office erstellt wurden, müssen Endbenutzercomputer über die Visual Studio Tools for Office-Laufzeit verfügen. Die Laufzeit umfasst verwaltete Assemblys, die die Kommunikationsschicht zwischen der Projektmappe und der Microsoft Office-Anwendung darstellen, und nicht verwaltete Komponenten, die die Anwendung zum Laden der Projektmappe verwendet.

Informationen über das Installieren der Laufzeit auf Endbenutzercomputern finden Sie unter Gewusst wie: Installieren der Visual Studio Tools for Office Runtime.

Dieses Thema enthält folgende Informationen:

Informationen zu den verschiedenen Laufzeitversionen
Informationen zu den Laufzeitassemblys
Informationen zu den Ladeprogrammkomponenten der Laufzeit

Informationen zu den verschiedenen Laufzeitversionen

Visual Studio Tools for Office-Projektmappen für unterschiedliche Versionen von Microsoft Office erfordern unterschiedliche Versionen der Laufzeit. Die Laufzeitversion wird durch die Projektvorlage bestimmt, die zum Erstellen der Projektmappe verwendet wurde, und nicht durch die Version von Office, unter der diese Projektmappe ausgeführt wird.

In der folgenden Tabelle wird dargestellt, welche Laufzeitversionen und welche Microsoft Office-Versionen erforderlich sind, um Projektmappen auf dem Endbenutzercomputer auszuführen.

Version der Projektvorlage	Erforderliche Visual Studio Tools for Office-Laufzeitversion auf dem Endbenutzercomputer	Microsoft Office-Versionen, unter denen die Projektmappe auf dem Endbenutzercomputer ausgeführt werden kann
Projekte für 2007 Microsoft Office System	Microsoft Visual Studio Tools für Microsoft Office System (Version 3.0-Laufzeit)	2007 Microsoft Office System
Projekte für Microsoft Office 2003	Laufzeit für Visual Studio 2005 Tools for Office Second Edition	2007 Microsoft Office System Microsoft Office 2003

Version der Projektvorlage

Erforderliche Visual Studio Tools for Office-Laufzeitversion auf dem Endbenutzercomputer

Microsoft Office-Versionen, unter denen die Projektmappe auf dem Endbenutzercomputer ausgeführt werden kann

Projekte für 2007 Microsoft Office System

Microsoft Visual Studio Tools für Microsoft Office System (Version 3.0-Laufzeit)

2007 Microsoft Office System

Projekte für Microsoft Office 2003

Laufzeit für Visual Studio 2005 Tools for Office Second Edition

2007 Microsoft Office System

Microsoft Office 2003

Beide Versionen der Laufzeit werden automatisch auf dem Entwicklungscomputer installiert, wenn Sie Microsoft Visual Studio Tools für Microsoft Office System (Version 3.0) installieren.

Informationen über das Erstellen von Projektmappen, die mit beiden Versionen von Microsoft Office ausgeführt werden können, finden Sie unter Erstellen von Projektmappen für mehrere Versionen von Microsoft Office.

Es gibt einige Unterschiede zwischen den Assemblys, die in jeder Version der Laufzeit enthalten sind. Weitere Informationen dazu finden Sie unter Unterschiede zwischen den Assemblys.

Hinweis:
Laufzeit für Visual Studio 2005 Tools for Office Second Edition wurde anfänglich mit Microsoft Visual Studio 2005-Tools für 2007 Microsoft Office System (VSTO 2005 SE) veröffentlicht. Diese Version der Laufzeit wird auch von Projektmappen für Microsoft Office 2003 verwendet, die mit Microsoft Visual Studio Tools für Microsoft Office System (Version 3.0) erstellt wurden.

Suchen nach Referenzdokumentation für beide Laufzeiten

Wenn Sie auf einen Link oder einen Indexeintrag in der Hilfe klicken, um Referenzinformationen zu einem Namespace, Typ oder Member abzurufen, erhalten Sie möglicherweise zwei fast identische Ergebnisse. Die beiden Themen dokumentieren denselben Member in den zwei Versionen der Laufzeit. Wählen Sie das Thema aus, das vom entsprechenden Versionsindikator identifiziert wird:

2007 System. Dies verweist auf Microsoft Visual Studio Tools für Microsoft Office System (Version 3.0-Laufzeit).
2003 System. Dies verweist auf Laufzeit für Visual Studio 2005 Tools for Office Second Edition.

Informationen zu den Laufzeitassemblys

Die Assemblys, die in der Visual Studio Tools for Office-Laufzeit enthalten sind, stellen Klassen der folgenden Kategorien bereit:

Klassen, die die Projektmappe verwendet, um die Hostanwendung zu automatisieren und zu erweitern.
Infrastrukturklassen, die es der Projektmappe ermöglichen, mit der Hostanwendung zu kommunizieren.

Hinweis:
Wenn Sie ein Projekt erstellen, fügt Visual Studio Tools for Office automatisch Verweise auf die Assemblys hinzu, die für den Projekttyp verwendet werden. Einige der Assemblys werden nur in Projekten auf Dokumentebene verwendet, andere wiederum ausschließlich in Projekten auf Anwendungsebene.

Assemblys in der Laufzeit für Visual Studio Tools for Office 3.0

In der folgenden Tabelle werden die Assemblys aufgelistet, die in Microsoft Visual Studio Tools für Microsoft Office System (Version 3.0-Laufzeit) enthalten sind. Diese Version der Laufzeit wird von Projektmappen verwendet, die für 2007 Microsoft Office System erstellt wurden.

Eine Dokumentation über die Namespaces und die Klassen in diesen Assemblys finden Sie in Verwaltete Referenz für 2007 System.

Assemblyname	Beschreibung
Microsoft.Office.Tools.Common.v9.0.dll	Stellt folgende Klassen zur Verfügung: Die AddIn-Basisklasse für Add-Ins auf Anwendungsebene Klassen zum Erstellen von Aktionsbereichen und Smarttags in Anpassungen auf Dokumentebene Klassen zum Erstellen von benutzerdefinierten Aufgabenbereichen in Add-Ins auf Anwendungsebene Klassen zum Erstellen von angepassten Multifunktionsleisten Die ExcelLocale1033Attribute-Klasse und die ExcelLocale1033Proxy-Klasse, mit denen Excel-Projektmappen die Gebietsschema-ID (LCID) steuern, die für alle kulturabhängigen Aufrufe an das Excel-Objektmodell verwendet wird. Weitere Informationen finden Sie unter Formatieren von Daten in Excel mit verschiedenen regionalen Einstellungen.
Microsoft.Office.Tools.Excel.v9.0.dll	Stellt Hostelemente und Hoststeuerelemente für Anpassungen auf Dokumentebene in Excel bereit. Weitere Informationen finden Sie unter Übersicht über Hostelemente und Hoststeuerelemente.
Microsoft.Office.Tools.Outlook.v9.0.dll	Stellt Klassen bereit, mit denen Sie benutzerdefinierte Formularbereiche in Outlook-Add-Ins erstellen können.
Microsoft.Office.Tools.Word.v9.0.dll	Stellt Hostelemente und Hoststeuerelemente für Anpassungen auf Dokumentebene in Word bereit. Weitere Informationen finden Sie unter Übersicht über Hostelemente und Hoststeuerelemente.
Microsoft.Office.Tools.v9.0.dll	Stellt folgende Klassen zur Verfügung: Die RemoteBindableComponent-Klasse, die die Datenbindungsfähigkeiten für Hoststeuerelemente in Anpassungen auf Dokumentebene bereitstellt Andere Klassen, die Teil von Microsoft Visual Studio Tools für Microsoft Office System (Version 3.0-Laufzeit)-Infrastruktur sind und nicht für die direkte Verwendung durch den Code vorgesehen sind
Microsoft.VisualStudio.Tools.Applications.Runtime.v9.0.dll	Stellt folgende Klassen zur Verfügung: Das CachedAttribute-Attribut und die ICachedType-Klassen, die zum Zwischenspeichern von Datenobjekten in einer Anpassung auf Dokumentebene verwendet werden können Ausnahmen, die von der Visual Studio Tools for Office-Laufzeit ausgelöst werden können Andere Klassen, die Teil von Microsoft Visual Studio Tools für Microsoft Office System (Version 3.0-Laufzeit)-Infrastruktur sind und nicht für die direkte Verwendung durch den Code vorgesehen sind
Microsoft.VisualStudio.Tools.Applications.ServerDocument.v9.0.dll	Stellt folgende Klassen zur Verfügung: Die ServerDocument-Klasse, die zum programmgesteuerten Anfügen von Anpassungsassemblys an Dokumente und zum Zugreifen auf die zwischengespeicherten Daten in Dokumenten verwendet werden kann Mehrere Klassen, die die Hierarchie der zwischengespeicherten Daten in einer Anpassung auf Dokumentebene darstellen
Microsoft.VisualStudio.Tools.Office.Runtime.v9.0.dll	Stellt folgende Klassen zur Verfügung: Die AddInSecurityEntry-Klasse und die UserInclusionList-Klasse, mit denen Sie Aufnahmelisteneinträge für Benutzer erstellen können, um einer Visual Studio Tools for Office-Projektmappen Vertrauenswürdigkeit für 2007 Microsoft Office System zu gewähren Weitere Informationen hierzu finden Sie unter Gewähren von Vertrauenswürdigkeit für Office-Projektmappen mithilfe von Aufnahmelisten (2007 System). Andere Klassen, die Teil von Microsoft Visual Studio Tools für Microsoft Office System (Version 3.0-Laufzeit)-Infrastruktur sind und nicht für die direkte Verwendung durch den Code vorgesehen sind
Microsoft.VisualStudio.Tools.Office.AppInfoDocument.v9.0.dll Microsoft.VisualStudio.Tools.Office.Contract.v9.0.dll	Stellen Klassen bereit, die Teil von Microsoft Visual Studio Tools für Microsoft Office System (Version 3.0-Laufzeit)-Infrastruktur sind. Diese Klassen sind nicht für die direkte Verwendung durch den Code vorgesehen.

Assemblys in der Laufzeit für Visual Studio 2005 Tools for Office Second Edition

In der folgenden Tabelle werden die Assemblys aufgelistet, die in Laufzeit für Visual Studio 2005 Tools for Office Second Edition enthalten sind. Diese Version der Laufzeit wird von für Microsoft Office 2003 erstellten Projektmappen verwendet.

Eine Dokumentation über die Namespaces und die Klassen in diesen Assemblys finden Sie in Verwaltete Verweise für 2003 System.

Assemblyname	Beschreibung
Microsoft.Office.Tools.Common.dll	Stellt folgende Klassen zur Verfügung: Die AddIn-Basisklasse für Add-Ins auf Anwendungsebene Klassen zum Erstellen von Aktionsbereichen und Smarttags in Anpassungen auf Dokumentebene
Microsoft.Office.Tools.Excel.dll	Stellt Hostelemente und Hoststeuerelemente für Anpassungen auf Dokumentebene in Excel bereit. Weitere Informationen finden Sie unter Übersicht über Hostelemente und Hoststeuerelemente.
Microsoft.Office.Tools.Word.dll	Stellt Hostelemente und Hoststeuerelemente für Anpassungen auf Dokumentebene in Word bereit. Weitere Informationen finden Sie unter Übersicht über Hostelemente und Hoststeuerelemente.
Microsoft.VisualStudio.Tools.Applications.Runtime.dll	Stellt folgende Klassen zur Verfügung: Die ServerDocument-Klasse, die zum programmgesteuerten Anfügen von Anpassungen an Dokumente und zum Zugreifen auf die zwischengespeicherten Daten in Dokumenten verwendet werden kann Das CachedAttribute-Attribut und die ICachedType-Klassen, die zum Zwischenspeichern von Datenobjekten in einer Anpassung auf Dokumentebene verwendet werden können Ausnahmen, die von der Visual Studio Tools for Office-Laufzeit ausgelöst werden können Andere Klassen, die Teil der Laufzeit für Visual Studio 2005 Tools for Office Second Edition-Infrastruktur sind und nicht für die direkte Verwendung durch den Code vorgesehen sind

Unterschiede zwischen den Assemblys

Mehrere Assemblys, die in Laufzeit für Visual Studio 2005 Tools for Office Second Edition enthalten sind, haben in Microsoft Visual Studio Tools für Microsoft Office System (Version 3.0-Laufzeit) andere Namen. Außerdem wurde eine Assembly, die Teil von Laufzeit für Visual Studio 2005 Tools for Office Second Edition ist, in Microsoft Visual Studio Tools für Microsoft Office System (Version 3.0-Laufzeit) in mehrere neue Assemblys aufgeteilt

In der folgenden Tabelle sind die Unterschiede aufgelistet.

Name der Assembly in	Name der Assembly in Microsoft Visual Studio Tools für Microsoft Office System (Version 3.0-Laufzeit)
Microsoft.Office.Tools.Common.dll	Microsoft.Office.Tools.Common.v9.0.dll
Microsoft.Office.Tools.Excel.dll	Microsoft.Office.Tools.Excel.v9.0.dll
Microsoft.Office.Tools.Word.dll	Microsoft.Office.Tools.Word.v9.0.dll
Microsoft.VisualStudio.Tools.Applications.Runtime.dll	Microsoft.VisualStudio.Tools.Applications.Runtime.v9.0.dll Einige Klassen wurden auch in die folgenden neuen Assemblys verschoben: Microsoft.Office.Tools.v9.0.dll Microsoft.VisualStudio.Tools.Applications.ServerDocument.v9.0.dll

Informationen zu den Ladeprogrammkomponenten der Laufzeit

Die Visual Studio Tools for Office-Laufzeit schließt mehrere nicht verwaltete DLLs ein, die Microsoft Office-Anwendungen verwenden, um Visual Studio Tools for 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 Visual Studio Tools for 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

Laufzeitladeprogramm

Wenn ein Benutzer eine Anpassung auf Dokumentebene öffnet oder ein Add-In startet, ruft die Microsoft Office-Anwendung das Laufzeitladeprogramm auf. Diese Komponente wird VSTOEE.dll genannt.

Das Laufzeitladeprogramm stellt sicher, dass die richtige Version der Visual Studio Tools for Office-Laufzeit für die Microsoft Office-Version, die das Add-In lädt, geladen wird. Obwohl mehrere Versionen der Visual Studio Tools for Office-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.

Projektmappenladeprogramm

Das Projektmappenladeprogramm führt die meisten Aufgaben aus, die zum Laden der Projektmappenassembly erforderlich sind. Das Projektmappenladeprogramm hat je nach Version der Visual Studio Tools for Office-Laufzeit unterschiedliche Dateinamen. Das Projektmappenladeprogramm in Microsoft Visual Studio Tools für Microsoft Office System (Version 3.0-Laufzeit) wird VSTOLoader.dll genannt. In Laufzeit für Visual Studio 2005 Tools for Office Second Edition lautet es AddinLoader.dll.

Das Projektmappenladeprogramm führt mehrere Aufgaben aus:

Es erstellt eine neue Anwendungsdomäne für jede Visual Studio Tools for Office-Projektmappenassembly.
Es führt einen Satz von Sicherheitsüberprüfungen aus, um zu überprüfen, ob die Add-In-Assembly über die Berechtigung zum Ausführen verfügt.

Das Projektmappenladeprogramm 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 ab der Version 2007 von Microsoft Office-Anwendungen verwendet, um Visual Studio Tools for Office-Add-Ins zu laden. Weitere Informationen finden Sie unter IManagedAddin-Schnittstelle.

Siehe auch

Freigeben über