Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Visual Studio 2019 Port, Migration und Upgrade von ProjektenVon Bedeutung
Dies ist nicht die neueste Version von Visual Studio. Um die neueste Version herunterzuladen, besuchen https://visualstudio.microsoft.com/downloads/ Sie bitte die Versionshinweise zu Visual Studio 2022.
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
Wenn Sie spezifische Informationen zu unserer nächsten Version suchen, lesen Sie die Visual Studio 2022-Version 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 beizubehalten. 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.
Von Bedeutung
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 "Plattformadressierung 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 hier kein Projekt oder Dateityp aufgeführt ist, lesen Sie die Visual Studio 2017-Version dieses Artikels. Sie können auch die Schaltfläche "Absenden und Feedback anzeigen für>diese Seite" unten auf dieser Seite verwenden, um Details zu Ihrem Projekt bereitzustellen. (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 löst keinen Konflikt aus. 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, und die Ressourceninformationen werden jeweils verwendet, solange Visual Studio Projekte und Lösungen unterstützt, die in beiden Versionen verwendet werden. Benutzer müssen sich einmal für jedes Produkt authentifizieren. Wenn beispielsweise ein Projekt mit Visual Studio 2017 erstellt und in Visual Studio 2019 geöffnet wird, muss sich der Benutzer bei 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. Überprüfen Sie die Verfügbarkeit von Visual Studio 2019 mit Revenera . |
| 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 | Webleistungs- und Auslastungstestfunktionen 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:
|
| Modeling | 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 | Erfordert ein unidirektionales Upgrade für Visual Studio 2019. |
| 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 es in Visual Studio 2019 keine Entsprechung gibt, 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 Application-Projekte können in Visual Studio 2015, Visual Studio 2017 und Visual Studio 2019 geöffnet werden, es sei denn, das Service Fabric Application-Projekt verweist auf ein ASP.NET Core-Dienstprojekt. Service Fabric-Projekte aus Visual Studio 2015, die in Visual Studio 2017 oder in Visual Studio 2019 geöffnet werden, werden unidirektional aus dem xproj-Format zu csproj migriert. Weitere Informationen finden Sie weiter oben in dieser Tabelle unter ".NET Core-Projekte (xproj)". |
| SharePoint 2010 | Wenn ein SharePoint-Lösungsprojekt mit Visual Studio 2019 geöffnet wird, wird es auf SharePoint 2013 oder SharePoint 2016 aktualisiert. Die Workload ".NET Desktop Development" 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 | SharePoint-Add-In Projekte, die in Office Developer Tools Preview 2 erstellt wurden, können in Visual Studio 2019 nicht 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 ", im Teamblog zu SQL Server Integration Services (SSIS) und auf der Seite "SQL Server Integration Services Projects " auf dem 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 an Projekten zu arbeiten, die in früheren Versionen von Visual Studio bis zurück 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 die Ursprünglichen weiterhin verwenden möchten, ändert Visual Studio 2019 die Projektdatei nicht und verwendet das Toolset aus 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 es in Visual Studio 2019 keine Entsprechung gibt, 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 es in Visual Studio 2019 keine Entsprechung gibt, 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 für 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. Dadurch wird der Kopplungsbildschirm und jede Integration entfernt. Verwenden Sie stattdessen den integrierten Xamarin.Forms Previewer. 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. (Siehe Plattformadressierung und Kompatibilität , für welche Projekttypen in Visual Studio 2019 unterstützt werden.) In diesem Fall lädt eine neuere Version von Visual Studio das Projekt nicht oder bietet einen Migrationspfad. 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, aber es muss das Projekt so aktualisieren oder migrieren, dass es möglicherweise nicht mehr mit früheren Versionen kompatibel ist. 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. (Nämlich unterschiedliche 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; Visual Studio 2010 SP 1.) Visual Studio 2019 zielt darauf ab, ordnungsgemäß mit veralteten Entwurfszeitressourcen zu scheitern, ohne sie zu beschädigen, sodass frühere Versionen das Projekt weiterhin ö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 bestimmte ToolsVersion-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 die Kompatibilität mit Projekten aufrechtzuerhalten, die Sie in früheren Versionen erstellt haben, enthält Visual Studio 2019 die erforderlichen MSBuild-Toolketten zur Unterstützung ToolsVersion von 15, 14, 12 und 4. Projekte, die diese ToolsVersion-Werte verwenden, sollten zu einem erfolgreichen Build führen. (Betrifft erneut, ob Visual Studio 2019 den Projekttyp unterstützt, wie unter "Plattformadressierung 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
Weitere Erläuterungen finden Sie in den folgenden Artikeln:
- ToolsVersion guidance (ToolsVersion-Leitfaden)
- Framework targeting guidance (Zielframework-Leitfaden)