Visual Studio 2019: Portieren, Migrieren und Upgraden von Projekten
Entwicklercommunity | Systemvoraussetzungen | Kompatibilität | Verteilbarer Code | Freigabeverlauf | Lizenzbedingungen | Blogs
Jede neue Version von Visual Studio unterstützt die meisten Typen von Projekten, Dateien und anderen Objekten. Sie können mit ihnen wie gewohnt arbeiten, vorausgesetzt, dass Sie nicht auf neuere Features angewiesen sind.
Tipp
Informationen zu unserem nächsten Release finden Sie in unter Visual Studio-Version 2022 auf dieser Seite.
Wir versuchen, die Abwärtskompatibilität mit früheren Versionen, wie Visual Studio 2017, Visual Studio 2015, Visual Studio 2013 und Visual Studio 2012, zu erhalten. Die Unterstützung einiger Projekttypen ändert sich jedoch im Laufe der Zeit. Möglicherweise unterstützt eine neuere Version von Visual Studio bestimmte Projekte nicht oder sie erfordert von Ihnen möglicherweise, dass Sie ein Projekt aktualisieren, sodass es nicht mehr abwärtskompatibel ist.
Hinweis
Informationen zum aktuellen Status von Problemen bei der Migration finden Sie auf der Website der Visual Studio Developer Community. Weitere Informationen darüber, welche Features für welche Visual Studio-Version spezifisch sind, finden Sie in den Versionshinweisen.
Wichtig
Einige Projekttypen erfordern bestimmte Workloads. Wenn die Workload nicht installiert ist, meldet Visual Studio einen unbekannten oder nicht kompatiblen Projekttyp. Überprüfen Sie in einem solchen Fall Ihre Installationsoptionen im Visual Studio-Installer, und versuchen Sie es dann erneut. Weitere Informationen zur Projektunterstützung in Visual Studio 2019 finden Sie auf der Seite Zielplattformen und Kompatibilität.
Projekttypen
In der folgenden Liste wird die Unterstützung in Visual Studio 2019 für Projekte beschrieben, die in früheren Versionen erstellt wurden.
Wenn Sie ein Projekt oder einen Dateityp, der hier aufgeführt sein sollte, nicht finden, konsultieren Sie die Version dieses Artikels zu Visual Studio 2017. Sie können auch die Schaltfläche Feedback senden und anzeigen für>Diese Seite unten auf dieser Seite verwenden, um Details zu Ihrem Projekt anzugeben. (Wenn Sie das anonyme Steuerelement „Hilft Ihnen diese Seite weiter?“ verwenden, können wir nicht auf Ihr Feedback reagieren.)
| Projekttyp | Support |
|---|---|
| .NET Core-Projekte (XPROJ) | Mit Visual Studio 2015 erstellte Projekte verwendeten die Vorschautools, die eine XPROJ-Projektdatei enthielten. Visual Studio 2017: Das XPROJ-Format wird abgesehen für die Migration zum CSPROJ-Format nicht unterstützt. Wenn Sie eine XPROJ-Datei öffnen, werden Sie aufgefordert, die Datei zum SDK-Formatvorlagenformat CSPROJ zu migrieren. (Es wird eine Sicherungskopie der XPROJ-Datei erstellt.) CSPROJ-Projekte im SDK-Stil werden in Visual Studio 2015 und früheren Versionen nicht unterstützt. Visual Studio 2019: In Version 16.3 und höher können Sie keine XPROJ-Projekte laden oder migrieren. Weitere Informationen finden Sie unter Migrieren von .NET Core-Projekten in das CSPROJ-Format. |
| ASP.NET Core-Web-App und ASP.NET Core-Web-App mit Aktivierung von „Application Insights“ | Für jeden Visual Studio-Benutzer wird die Ressourceninformation pro Benutzerinstanz in der Registrierung gespeichert. Diese Informationen werden verwendet, wenn ein Benutzer kein Projekt geöffnet hat und Azure Application Insights-Daten durchsuchen möchte. Visual Studio 2015 verwendet einen anderen Registrierungsspeicherort als Visual Studio 2017 und Visual Studio 2019 und verursacht keine Konflikte. Sobald ein Benutzer eine ASP.NET-Webanwendung, eine ASP.NET Core-Web-App oder eine ASP.NET Core-Webanwendung erstellt, wird die Ressource in der SUO-Datei gespeichert. Der Benutzer kann das Projekt in Visual Studio 2015, Visual Studio 2017 oder Visual Studio 2019 öffnen. Die Ressourceninformationen werden verwendet, solange Visual Studio Projekte unterstützt und Projektmappen in beiden Versionen verwendet werden. Benutzer müssen sich einmal für jedes Produkt authentifizieren. Wenn ein Projekt beispielsweise mit Visual Studio 2017 erstellt und in Visual Studio 2019 geöffnet wird, muss der Benutzer sich für Visual Studio 2019 authentifizieren. |
| C#/Visual Basic Webform oder Windows Form | Sie können das Projekt in Visual Studio 2019, Visual Studio 2017 und Visual Studio 2015 öffnen. |
| Test der programmierten UI | Tests der programmierten UI für automatisierte, über die Benutzeroberfläche gesteuerte Funktionstests sind ab Visual Studio 2019 veraltet. Visual Studio 2019 ist das letzte Release für Tests der programmierten UI. Es wird empfohlen, dass Sie Selenium für das Testen von Web-Apps und Appium mit WinAppDriver für das Testen von Desktop- und UWP-Apps verwenden. |
| Datenbankkomponententest-Projekte (CSPROJ, VBPROJ) | Ältere Projekte für Datenkomponententests werden in Visual Studio 2019 geladen, verwenden jedoch die GAC-Version der abhängigen Komponenten. Klicken Sie mit der rechten Maustaste in Projektmappen-Explorer, und wählen Sie In SQL Server-Komponententestprojekt konvertieren... aus, um das Projekt für Komponententests für die Verwendung der aktuellen Abhängigkeiten zu aktualisieren. |
| F# | In Visual Studio 2013, Visual Studio 2015 und Visual Studio 2017 erstellte Projekte können mit Visual Studio 2019 geöffnet werden. Ein wichtiger Unterschied der neuen Projekte zu älteren Visual Studio-Vorlagen besteht darin, dass die FSharp.Core-Version immer ein NuGet-Paket ist. F# wird standardmäßig mit jeder .NET-Workload installiert. |
| InstallShield MSI-Setup |
In Visual Studio 2010 erstellte Installer-Projekte können mithilfe der Visual Studio-Installer-Projekt-Erweiterung in höheren Versionen geöffnet werden. Weitere Informationen finden Sie auch unter WiX Toolset Visual Studio 2017 Extension (Visual Studio 2017-Erweiterung WiX Toolset). InstallShield Limited Edition ist nicht mehr in Visual Studio enthalten. Erkundigen Sie sich bei Revenera nach der Verfügbarkeit für Visual Studio 2019. |
| LightSwitch | LightSwitch wird in Visual Studio 2022, Visual Studio 2019 und Visual Studio 2017 nicht mehr unterstützt. Projekte, die mit Visual Studio 2012 und früher erstellt und in Visual Studio 2013 oder 2015 geöffnet wurden, werden aktualisiert und können anschließend nur noch in Visual Studio 2013 oder Visual Studio 2015 geöffnet werden. |
| Auslastungstest | Funktionen für Webleistungs- und Auslastungstests sind in Visual Studio 2019 und höher veraltet. Visual Studio 2019 ist das letzte Release für Auslastungstests. Verwenden Sie stattdessen alternative Auslastungstesttools wie Apache JMeter, Akamai CloudTest und Blazemeter. |
| Microsoft Azure-Tools für Visual Studio | Um diese Projekttypen zu öffnen, müssen Sie zunächst das Azure SDK für .NETinstallieren. Danach können Sie das Projekt öffnen. Bei Bedarf wird Ihr Projekt aktualisiert. |
| Microsoft Test Manager | Microsoft Test Manager und Feedback Client sind ab Visual Studio 2019 nicht mehr im Lieferumfang enthalten. Nutzen Sie Azure Test Plans (eine Komponente von Azure DevOps) für Ihre manuellen und explorativen Tests. |
| Model View Controller-Framework (ASP.NET MVC) | Unterstützung für MVC-Versionen und Visual Studio:
Upgraden der MVC-Versionen:
|
| Modellierung | Wenn Sie zulassen, dass Visual Studio das Projekt automatisch aktualisiert, können Sie es in Visual Studio 2015, Visual Studio 2013 oder Visual Studio 2012 öffnen. Das Format des Modellierungsprojekts hat sich seit Visual Studio 2015 nicht geändert. Das Projekt kann in diesen Versionen geöffnet und verändert werden. Allerdings gibt es Unterschiede im Verhalten zwischen Visual Studio 2017 und Visual Studio 2019:
|
| MSI-Setup (VDPROJ) | Siehe Abschnitt „InstallShield“ dieser Seite. |
| Office 2007 VSTO | Ein unidirektionales Upgrade für Visual Studio 2019 ist erforderlich. |
| Office 2010 VSTO | Wenn das Projekt auf .NET Framework 4 abzielt, können Sie es in Visual Studio 2010 SP1 und höher öffnen. Alle anderen Projekte erfordern ein unidirektionales Upgrade. |
| Portable Klassenbibliothek | Portable Klassenbibliotheken werden nicht mehr unterstützt. Sie können weiterhin mit Visual Studio 2019 geöffnet und kompiliert werden, aber es können keine neuen PCL-Projekte erstellt werden. Es wird empfohlen, Code aus Projekten mit portabler Klassenbibliothek in .NET Standard-Projekte zu migrieren. Die Unterstützung von portablem Klassenbibliotheken wird nicht mehr standardmäßig enthalten sein, allerdings wird sie weiterhin auf der Registerkarte „Einzelne Komponenten“ von Visual Studio verfügbar sein. |
| Python-Workload | Die Unterstützung von Windows IoT Core-Apps mit Python wird mit Visual Studio 2019 entfernt. Da in Visual Studio 2019 keine Entsprechung vorhanden ist, gibt es keinen automatischen Migrationspfad für solche Projekte. Sie können weiterhin Visual Studio 2017 verwenden. |
| R-Tools für Visual Studio | R Tools für Visual Studio wurden in Visual Studio 2019 aus der Data Science-Workload entfernt. Sie können weiterhin Visual Studio 2017 oder Alternativen wie RStudio verwenden. |
| Service Fabric (SFPROJ) | Service Fabric-Anwendungsprojekte können entweder in Visual Studio 2015, Visual Studio 2017 oder Visual Studio 2019 geöffnet werden, sofern das Service Fabric-Anwendungsprojekt nicht auf ein ASP.NET Core-Dienstprojekt verweist. Service Fabric-Projekte aus Visual Studio 2015, die in Visual Studio 2017 oder Visual Studio 2019 geöffnet werden, werden unidirektional vom XPROJ-Format in das CSPROJ-Format migriert. Siehe „.NET Core-Projekte (XPROJ)“ weiter oben in dieser Tabelle. |
| SharePoint 2010 | Wenn ein SharePoint-Projektmappenprojekt mit Visual Studio 2019 geöffnet wird, wird es entweder auf SharePoint 2013 oder SharePoint 2016 aktualisiert. Die Arbeitsauslastung „.NET-Desktopentwicklung“ muss für das Upgrade in Visual Studio 2019 installiert werden. Weitere Informationen zum Upgrade von SharePoint-Projekten finden Sie unter Upgrade and Update – SharePoint. |
| SharePoint 2016 | In Office Developer Tools Preview 2 erstellte SharePoint-Add-In-Projekte können nicht in Visual Studio 2019 geöffnet werden. Zur Umgehung dieser Einschränkung können Sie die MinimumVisualStudioVersion in der CSPROJ-VBPROJ-Datei auf 12.0 und die MinimumOfficeToolsVersion auf 12.2 um diese Einschränkung zu umgehen. |
| Silverlight | Silverlight-Projekte werden in Visual Studio 2019 nicht unterstützt. Um Silverlight-Anwendungen zu verwalten, verwenden Sie weiterhin Visual Studio 2015. |
| SQL – Redgate | SQL Change Automation Core (zuvor als „ReadyRoll Core“ bezeichnet), SQL Prompt Core und SQL Search von Redgate sind nicht mehr im Lieferumfang des Visual Studio-Installers enthalten. Für diese Features können Sie weiterhin Visual Studio 2017 verwenden. In Visual Studio 2019 können Sie ein Upgrade auf die kostenpflichtigen Versionen von SQL Change Automation und SQL Prompt durchführen, die im Redgate SQL Toolbelt-Paket enthalten sind. |
| SQL Server Reporting Services und SQL Server Analysis Services (SSRS, SSDT, SSAS, MSAS) | Unterstützung für diese Projekttypen wird durch zwei Erweiterungen im Visual Studio-Katalog bereitgestellt: Microsoft Analysis Services Projects und Microsoft Reporting Services Projects. SSDT-Unterstützung ist auch in der Arbeitsauslastung für Datenspeicherung und -verarbeitung in Visual Studio 2019 enthalten. Weitere Informationen finden Sie auf der Seite Herunterladen und Installieren von SQL Server Data Tools (SSDT) für Visual Studio. |
| SQL Server Integration Services (SSIS) | Unterstützung für Visual Studio 2019 ist verfügbar. Weitere Informationen finden Sie auf der Seite Herunterladen und Installieren von SQL Server Data Tools (SSDT) für Visual Studio und im Teamblog zu SQL Server Integration Services (SSIS) sowie auf der Seite SQL Server Integration Services-Projekte im Marketplace. |
| Testfenstererweiterung | In Visual Studio 2019 wurden einige Testfenster-APIs, die zuvor als öffentlich markiert waren, aber nie offiziell dokumentiert wurden, entfernt. Weithin sichtbare APIs wurden in Visual Studio 2017 als veraltet markiert, um Verantwortliche für die Erweiterungsverwaltung frühzeitig zu warnen. Nach unseren Erkenntnissen besitzen nur wenige Erweiterungen Abhängigkeiten von diesen APIs. Weitere Informationen und Updateansichten finden Sie in der vollständigen Liste veralteter testbezogener APIs. Wenn Ihr Szenario betroffen ist, teilen Sie uns dies über die Visual Studio-Entwicklercommunity mit. |
| Visual C++ | Sie können Visual Studio 2019 verwenden, um in Projekten zu arbeiten, die in Vorgängerversionen von Visual Studio (zurückgehend bis zu Visual Studio 2010) erstellt wurden. Wenn Sie das Projekt zum ersten Mal öffnen, haben Sie die Möglichkeit, ein Upgrade auf den neuesten Compiler bzw. das neueste Toolset auszuführen oder weiterhin die ursprünglichen zu verwenden. Wenn Sie sich dazu entschließen, weiterhin die Originaldateien zu verwenden, nimmt Visual Studio 2019 keine Änderungen an der Projektdatei vor und verwendet das Toolset der früheren Visual Studio-Installation, um Ihr Projekt zu erstellen. Die Beibehaltung der ursprünglichen Optionen bedeutet, dass Sie bei Bedarf immer noch das Projekt in der ursprünglichen Version von Visual Studio öffnen können. Weitere Informationen finden Sie unter Use native multi-targeting in Visual Studio to build old projects (Verwenden der nativen Festlegung von Zielversionen in Visual Studio, um alte Projekte zu erstellen). |
| Visual Studio-Erweiterbarkeit/VSIX | Projekte, bei denen das Element „MinimumVersion“ auf „14.0“ oder weniger festgelegt ist, werden auf den Wert „15.0“ aktualisiert. Dadurch wird verhindert, dass das Projekt in früheren Versionen von Visual Studio verwendet wird. Damit Sie ein Projekt in früheren Versionen öffnen können, legen Sie MinimumVersion auf $(VisualStudioVersion) fest. Weitere Information finden Sie unter How to: Migrate Extensibility Projects to Visual Studio 2017 (Vorgehensweise: Migrieren von Erweiterungsprojekten zu Visual Studio 2017). |
| Visual Studio Lab Management | Sie können Microsoft Test Manager oder Visual Studio 2010 SP1 und höher verwenden, Umgebungen zu öffnen, die in einer dieser Versionen erstellt wurden. Allerdings muss die Version für Visual Studio 2010 SP1 von Microsoft Test Manager mit der Version von Team Foundation Server übereinstimmen, bevor Sie Umgebungen erstellen können. (Wichtig: Team Foundation Server bzw. TFS heißt jetzt Azure DevOps Server.) |
| Visual Studio-Tools für Apache Cordova | Die Unterstützung von Apache Cordova wurde mit Visual Studio 2019 entfernt. Da in Visual Studio 2019 keine Entsprechung vorhanden ist, gibt es keinen automatischen Migrationspfad für solche Projekte. Sie können die Erweiterung für Cordova-Tools für Visual Studio Code verwenden (die Unterstützung für die neueste Version von Cordova bereitstellt), oder verwenden Sie weiterhin Visual Studio 2017. |
| Webbereitstellung (WDPROJ) | Die Unterstützung für Webbereitstellungsprojekte wurde mit Einführung der Unterstützung für Veröffentlichungsprofile in Visual Studio 2012 eingestellt. Da in Visual Studio 2019 keine Entsprechung vorhanden ist, gibt es keinen automatischen Migrationspfad für solche Projekte. Öffnen Sie die WDPROJ-Datei stattdessen in einem Text-Editor, und nehmen Sie alle Anpassungen an der Veröffentlichungsprofildatei (PUBXML) durch Kopieren und Einfügen vor, wie beschrieben in StackOverflow. |
| Windows Communication Foundation und Windows Workflow Foundation | Sie können dieses Projekt in Visual Studio 2019, Visual Studio 2017, Visual Studio 2015, Visual Studio 2013 und Visual Studio 2012 öffnen. |
| Windows Presentation Foundation | Sie können dieses Projekt in Visual Studio 2019, Visual Studio 2017, Visual Studio 2013, Visual Studio 2012 und Visual Studio 2010 SP1 öffnen. |
| Windows Phone-Apps | Projekte für Windows Phone werden in Visual Studio 2019 nicht unterstützt. Verwenden Sie Visual Studio 2015 zum Verwalten von Apps für Windows Phone 8.x. Zum Verwalten von Windows Phone 7.x-Projekten verwenden Sie Visual Studio 2012. |
| Windows Store-Apps | Universelle Windows-Projekte mit JavaScript werden in Visual Studio 2019 nicht unterstützt. Verwenden Sie Visual Studio 2017 zum Verwalten dieser Projekte. Windows 10 SDKs, die vor dem Windows 10 Fall Creators Update (Build 16299) erstellt wurden, wurden aus dem Visual Studio 2019-Installer entfernt. Sie können die älteren SDKs manuell herunterladen, oder Sie weisen Ihre Projekte neueren SDKs zu. Universelle Windows-Projekte, die „project.json“ verwenden, werden nicht unterstützt. Es wird empfohlen, diese Projekte zu aktualisieren, sodass sie Paketverweise nutzen. Alternativ können Sie einen Verweis auf Version 16.0.0.0 von Microsoft.NET.Test.Sdk in die Datei „project.json“ einfügen. Projekte für Windows Store 8.1 und 8.0 werden in Visual Studio 2019 nicht unterstützt. Um diese Apps zu verwalten, verwenden Sie weiterhin Visual Studio 2015. |
| Xamarin | Die Xamarin Live Player-Erweiterung für Visual Studio und Visual Studio für Mac wurde entfernt. Damit werden die Anzeige für die Kopplung und all ihre Integrationen entfernt. Verwenden Sie stattdessen die integrierte Xamarin.Forms-Vorschau. Der Visual Studio-Emulator für Android wurde aus dem Visual Studio-Installer entfernt. Verwenden Sie stattdessen die neue Hyper-V-Unterstützung im Google Android-Emulator. |
Migrieren eines Projekts
Während wir versuchen, die Kompatibilität mit früheren Versionen aufrechtzuerhalten, kann es Änderungen geben, die mit früheren Versionen nicht kompatibel sind. (Unter Zielplattformen und Kompatibilität erfahren Sie, welche Projekttypen in Visual Studio 2019 unterstützt werden.) In diesem Fall wird eine neuere Version von Visual Studio das Projekt nicht laden oder einen Migrationspfad anbieten. Möglicherweise müssen Sie dieses Projekt in einer früheren Version von Visual Studio bearbeiten.
Manchmal kann die neuere Version von Visual Studio ein Projekt öffnen. Das Projekt muss jedoch aktualisiert oder migriert werden, sodass es mit früheren Versionen inkompatibel werden kann. Visual Studio bestimmt anhand der folgenden Kriterien, ob diese Migration erforderlich ist:
Kompatibilität mit den Zielversionen der Plattformen, bis zu Visual Studio 2013 RTM.
Kompatibilität der Entwurfszeitassets mit früheren Versionen von Visual Studio. (D.h. verschiedene Kanäle von Visual Studio 2019, Visual Studio 2017, Visual Studio 2015 RTM & Update 3, Visual Studio 2013 RTM & Update 5, Visual Studio 2012 Update 4 und Visual Studio 2010 SP 1.) Visual Studio 2019 zielt darauf ab, ordnungsgemäß mit veralteten Entwurfszeitassets fehlzuschlagen, ohne sie zu beschädigen, sodass frühere Versionen das Projekt immer noch öffnen können.
Ob die neuen Entwurfszeitassets die Kompatibilität mit vorherigen Versionen bis Visual Studio 2013 RTM & Update 5 beeinträchtigen.
Das Entwicklungsteam, das Besitzer des betreffenden Projekttyps ist, prüft diese Kriterien und führt den Aufruf für Support, Kompatibilität und Migration durch. Auch hier versuchen wir, die Kompatibilität zwischen den Visual Studio-Versionen aufrechtzuerhalten, sodass beim Erstellen und Ändern von Projekten in einer Version von Visual Studio, es nur in anderen Versionen funktioniert.
Manchmal ist eine Kompatibilität nicht möglich. Anschließend öffnet Visual Studio den Upgrade-Assistenten, um die erforderlichen unidirektionalen Änderungen vorzunehmen. Diese unidirektionalen Änderungen umfassen möglicherweise die Änderung der ToolsVersion-Eigenschaft in der Projektdatei. Diese kennzeichnet exakt, welche Version von MSBuild den Quellcode des Projekts nicht in ausführbare und bereitstellbare Elemente konvertieren kann, die Sie benötigen.
Die Inkompatibilität eines Projekts mit früheren Versionen von Visual Studio wird nicht durch die Visual Studio-Version, sondern durch die über ToolsVersion bestimmte MSBuild-Version verursacht. Wenn Ihre Version von Visual Studio über die MSBuild-Toolkette verfügt, die ToolsVersion in einem Projekt entspricht, kann Visual Studio diese Toolkette anschließend zum Erstellen des Projekts aufrufen.
Um Kompatibilität mit den in früheren Versionen erstellten Projekten zu gewährleisten, enthält Visual Studio 2019 die erforderlichen MSBuild-Toolketten zur Unterstützung der ToolsVersion 15, 14, 12 und 4. Projekte, die diese ToolsVersion-Werte verwenden, sollten zu einem erfolgreichen Build führen. (Wieder abhängig von der Tatsache, ob Visual Studio 2019 den Projekttyp unterstützt, wie in Zielplattformen und Kompatibilität beschrieben.)
Sie könnten versucht sein, ein Projekt manuell auf einen neueren ToolsVersion-Wert zu aktualisieren oder zu migrieren. Eine solche Änderung ist nicht erforderlich und erzeugt wahrscheinlich viele Fehler und Warnungen, die Sie beheben müssten, damit das Projekt erneut erstellt werden kann. Auch wenn Visual Studio in Zukunft keine bestimmte ToolsVersion unterstützt, löst das Projekt beim Öffnen den Migrationsvorgang aus, da sein ToolsVersion-Wert geändert werden muss.
Nächste Schritte
In den folgenden Artikeln finden Sie weitere Erläuterungen:
- ToolsVersion guidance (ToolsVersion-Leitfaden)
- Framework targeting guidance (Zielframework-Leitfaden)