Aktualisieren und Migrieren von Office-Projektmappen

Wenn Sie ein Microsoft Office-Projekt besitzen, das in einer früheren Version von Visual Studio erstellt wurde, müssen Sie das Projekt aktualisieren, um es in Visual Studio 2010 verwenden zu können. Um ein Microsoft Office-Projekt zu aktualisieren, öffnen Sie es in einer Version von Visual Studio 2010, die die Microsoft Office-Entwicklertools einschließt. Weitere Informationen zum Upgradeprozess finden Sie unter Gewusst wie: Aktualisieren von Office-Projektmappen. Weitere Informationen zu den Versionen von Visual Studio 2010, die die Microsoft Office-Entwicklertools einschließen, finden Sie unter Konfigurieren eines Computers zum Entwickeln von Office-Lösungen.

Wenn Sie ein Microsoft Office-Projekt aktualisieren, nimmt Visual Studio mehrere Änderungen am Projekt vor. Einige der Änderungen hängen von der Version von .NET Framework und Microsoft Office ab, die Sie auf dem Entwicklungscomputer installiert haben, und davon, ob das Projekt ein Projekt auf Dokumentebene oder ein Projekt auf Anwendungsebene ist.

Sie können auch jederzeit das Zielframework von Office-Projekten von .NET Framework 3.5 in .NET Framework 4 ändern (oder umgekehrt). Weitere Informationen finden Sie unter Gewusst wie: Ausrichten auf eine bestimmte .NET Framework-Version oder ein bestimmtes .NET Framework-Profil. Wenn Sie das Zielframework ändern, sind unter Umständen einige zusätzliche Schritte erforderlich, um die neu zugewiesene Lösung auf Entwicklungs- und Endbenutzercomputern auszuführen. Das Projekt wird nicht mehr kompiliert, wenn darin bestimmte Funktionen verwendet werden. Weitere Informationen finden Sie unter Migrieren von Office-Lösungen zu .NET Framework 4.

Unterstützte Projektupgradeversionen

Mit den folgenden Versionen von Visual Studio Tools for Office erstellte Microsoft Office-Projekte können aktualisiert werden:

• Microsoft Visual Studio 2005-Tools für Microsoft Office System.

• Microsoft Visual Studio 2005-Tools für 2007 Microsoft Office System (VSTO 2005 SE).

• Microsoft Visual Studio Tools für Microsoft Office System (Version 3.0). Diese Version von Visual Studio Tools for Office war in Visual Studio 2008 enthalten.

Visual Studio 2010 unterstützt nicht das Aktualisieren von mit Visual Studio-Tools for Office, Version 2003 erstellten Microsoft Office-Projekten. Um die Entwicklung eines dieser Projekte in Visual Studio 2010 fortzuführen, erstellen Sie ein neues Office-Projekt, und importieren Sie den Code manuell in das neue Projekt.

Änderungen an aktualisierten Projekten

Wenn Sie ein Microsoft Office-Projekt aktualisieren, werden die folgenden Änderungen am Projekt vorgenommen:

• Aktualisiert die Version der Visual Studio Tools for Office-Laufzeit, auf die das Projekt abzielt, auf Visual Studio 2010-Tools for Office-Laufzeit.

  Weitere Informationen zur Visual Studio Tools for Office-Laufzeit finden Sie unter Übersicht über die Visual Studio Tools for Office-Laufzeit.

• Aktualisiert ggf. die Version von .NET Framework, die als Ziel für das Projekt festgelegt wurde.

• Aktualisiert die Assemblyverweise im Projekt.

• Ändert das Projekt, um als Ziel die Version von Microsoft Office zu verwenden, die Sie auf dem Entwicklungscomputer installiert haben (Microsoft Office 2010 oder das 2007 Microsoft Office System), wenn für das ursprüngliche Projekt eine frühere Version von Microsoft Office als Ziel verwendet wurde. Wenn keine Version von Microsoft Office installiert ist, wird als Ziel für das aktualisierte Projekt das 2007 Microsoft Office System verwendet.

Als Ziel festgelegte .NET Framework-Version

Wenn Sie ein Visual Studio Tools for Office-Projekt in Visual Studio 2010 aktualisieren, wird die .NET Framework-Zielversion in den folgenden Fällen geändert:

• Für das ursprüngliche Projekt wurde als Zielversion .NET Framework 2.0 festgelegt. In diesem Fall wird das Projekt geändert, um als Zielversion .NET Framework 3.5 festzulegen, wenn sowohl .NET Framework 3.5 als auch .NET Framework 4 auf dem Entwicklungscomputer installiert sind. Wenn nur .NET Framework 4 installiert ist, wird das Projekt so geändert, dass als Zielversion .NET Framework 4 verwendet wird.

• Für das Projekt wurde als Zielversion .NET Framework 3.5 festgelegt, doch nur .NET Framework 4 ist auf dem Entwicklungscomputer installiert. In diesem Fall wird das Projekt geändert, um als Zielversion .NET Framework 4 festzulegen.

Wenn für das Projekt als Zielversion bereits .NET Framework 3.5 festgelegt wurde, wird das Zielframework nicht im aktualisierten Projekt aktualisiert, wenn .NET Framework 3.5 auch auf dem Entwicklungscomputer installiert ist.

In der folgenden Tabelle werden die Zielframeworkänderungen für aktualisierte Projekte zusammengefasst.

Zielframework des ursprünglichen Projekts	Frameworkversionen auf Entwicklungscomputer	Zielframework des aktualisierten Projekts
.NET Framework 2.0 .NET Framework 3.5	.NET Framework 3.5 und .NET Framework 4	.NET Framework 3.5 Hinweis Wenn für das ursprüngliche Projekt als Zielversion .NET Framework 3.5 Client Profile festgelegt wurde, wird für das aktualisierte Projekt als Zielversion .NET Framework 3.5 festgelegt.
.NET Framework 2.0 .NET Framework 3.5	.NET Framework 4	.NET Framework 4 Hinweis Wenn für das ursprüngliche Projekt als Zielversion .NET Framework 3.5 Client Profile festgelegt wurde, wird für das aktualisierte Projekt als Zielversion .NET Framework 4 Client Profile festgelegt.

Wenn Sie in einem Office-Projekt als Zielversion .NET Framework 4 festlegen, können Sie bestimmte Funktionen verwenden, die nicht verfügbar sind, wenn als Zielversion .NET Framework 3.5 festgelegt wird. Weitere Informationen finden Sie unter Entwerfen und Erstellen von Office-Lösungen.

Assemblyverweise

Die folgenden Assemblyverweise im Projekt werden aktualisiert:

• Primäre Interopassemblys für Microsoft Office

• Assemblys in Visual Studio Tools for Office-Laufzeit. Weitere Informationen zu diesen Assemblys finden Sie unter Übersicht über die Visual Studio Tools for Office-Laufzeit.

• Neue oder aktualisierte Versionen abhängiger Assemblys.

Es werden keine Verweise auf neue oder aktualisierte Versionen von Assemblys hinzugefügt, die dem ursprünglichen Projekt nach der Erstellung hinzugefügt wurden. Wenn Sie z. B. ein Word 2003-Add-In-Projekt aktualisieren, das auch auf die primäre Interopassembly von PowerPoint 2003 verweist, wird das aktualisierte Projekt so geändert, dass es auf die primäre Interopassembly von Word 2007 oder Word 2010 verweist. Allerdings muss der Verweis auf die primäre PowerPoint-Interopassembly manuell aktualisiert werden.

Aktualisieren von Microsoft Office 2003-Projekten

Sofern Microsoft Office 2010 oder das 2007 Microsoft Office System auf dem Entwicklungscomputer installiert ist, wenn ein Projekt aktualisiert wird, für das als Ziel Microsoft Office 2003 verwendet wird, wird standardmäßig das Projekt so geändert, dass als Ziel die installierte Version von Microsoft Office verwendet wird. Das Kontrollkästchen Immer Upgrade auf installierte Version von Office durchführen auf der Optionsseite Projektupgrade steuert dieses Verhalten. Wenn Sie dieses Kontrollkästchen deaktivieren, wird das Projekt nicht von Visual Studio geändert, um Microsoft Office 2010 oder das 2007 Microsoft Office System als Zielversion festzulegen, und das Projekt kann möglicherweise nicht entwickelt, debuggt oder ausgeführt werden. Weitere Informationen zu dieser Option finden Sie unter Dialogfeld "Optionen", "Projektupdate".

Für die Aktualisierung von Anpassungen auf Dokumentebene und Add-Ins auf Anwendungsebene für Microsoft Office 2003 gelten einige weitere Überlegungen.

Projekte auf Dokumentebene

Damit ein Projekt auf Dokumentebene für Microsoft Office 2003 aktualisiert werden kann, muss auf dem Entwicklungscomputer die entsprechende Microsoft Office 2010- oder 2007 Microsoft Office System-Anwendung installiert sein. Sie müssen z. B. auf dem Computer Word 2007 oder Word 2010 installieren, bevor Sie ein Word 2003-Projekt aktualisieren können.

Wenn Sie ein Projekt auf Dokumentebene mit einem Dokument aktualisieren, das in einem Binärformat gespeichert wird, müssen Sie festlegen, ob das Dokument in ein Open XML-Format konvertiert werden soll, oder ob für das Dokument ein Binärformat beibehalten werden soll. Wählen Sie Open XML aus, sofern Sie nicht aus einem bestimmten Grund das ältere Format verwenden. Weitere Informationen zu Open XML finden Sie unter Introduction to new file name extensions and Open XML Formats.

Falls das Dokument im Projekt Windows Forms-Steuerelemente enthält, müssen Sie die Visual Studio 2005-Tools für Office Second Edition-Laufzeit installieren, bevor Sie das Projekt aktualisieren. Wenn diese Version der Laufzeit vor dem Aktualisieren des Projekts nicht auf dem Entwicklungscomputer installiert wird, können im aktualisierten Projekt Kompilier- oder Laufzeitfehler auftreten. Nachdem Sie das Projekt aktualisiert haben, können Sie die Visual Studio 2005-Tools für Office Second Edition-Laufzeit vom Entwicklungscomputer deinstallieren, wenn sie nicht von anderen Office-Projektmappen verwendet wird. Diese Version der Laufzeit steht im Microsoft Download Center unter Microsoft Visual Studio 2005-Tools für Office Second Edition-Laufzeit (VSTO 2005 SE) (x86) als verteilbares Paket zur Verfügung.

Projekte auf Anwendungsebene

Wenn die Lösungsdatei für das ursprüngliche Projekt ein Setupprojekt beinhaltete, das dafür konfiguriert wurde, das Add-In auf Anwendungsebene zu installieren, wird das Setupprojekt auf ein Visual Studio 2010-Projekt aktualisiert, wobei jedoch keine weiteren Änderungen am Projekt vorgenommen werden. Wenn Sie das Add-In weiterhin mit einer Windows Installer-Datei bereitstellen möchten, muss das Setupprojekt so geändert werden, dass neue erforderliche Komponenten wie .NET Framework 4 oder .NET Framework 3.5, Visual Studio 2010-Tools for Office-Laufzeit und optional die primären Interopassemblys, auf die durch das Add-In verwiesen wird, installiert werden. Weitere Informationen finden Sie unter Bereitstellen einer Office-Lösung mithilfe von Windows Installer.

Wenn Sie das Add-In mit ClickOnce bereitstellen möchten, können Sie das Setupprojekt vollständig löschen. Weitere Informationen zum Bereitstellen von Add-Ins mithilfe von ClickOnce finden Sie unter Bereitstellen von Office-Projektmappen.

Siehe auch

Aufgaben

Gewusst wie: Aktualisieren von Office-Projektmappen

Referenz

Dialogfeld "Optionen", "Projektupdate"

Weitere Ressourcen

Migrieren von Office-Lösungen zu .NET Framework 4