Projektmigration und Upgradereferenz für Visual Studio 2017Project migration and upgrade reference for Visual Studio 2017

Jede neue Version von Visual Studio unterstützt im Allgemeinen die meisten vorherigen Typen von Projekten, Dateien und anderen Objekten.Each new version of Visual Studio generally supports most previous types of projects, files, and other assets. Sie können wie gewohnt mit ihnen arbeiten, vorausgesetzt, Sie sind nicht von neueren Features abhängig. Visual Studio behält die Abwärtskompatibilität mit vorherigen Versionen wie Visual Studio 2015, Visual Studio 2013 und Visual Studio 2012 im Allgemeinen bei.You can work with them as you always have, and provided that you don't depend on newer features, Visual Studio generally tries to preserve backwards compatibility with previous versions like Visual Studio 2015, Visual Studio 2013, and Visual Studio 2012. Informationen dazu, welche Features für welche Versionen spezifisch sind, finden Sie in den Anmerkungen zu dieser Version.(See the Release Notes for which features are specific to which versions.)

Die Unterstützung für einige Projekttypen ändert sich im Laufe der Zeit.Support for some project types also changes over time. Eine neuere Version von Visual Studio unterstützt bestimmte Projekte möglicherweise nicht mehr oder setzt Updates für Projekte voraus, sodass sie nicht mehr abwärtskompatibel sind.A newer version of Visual Studio may no longer support certain projects at all, or requires updating a project such that it's no longer backwards compatible. Informationen zum aktuellen Status von Problemen bei der Migration finden Sie auf der Website der Visual Studio Developer Community.For current status on migration issues, refer to the Visual Studio Developer Community site.

Dieser Artikel enthält zurzeit nur Einzelheiten zu Projekttypen, die Visual Studio 2017 migrieren kann.This present article provides details only for project types that Visual Studio 2017 can migrate. Projekttypen, die in Visual Studio 2017 nicht mehr unterstützt werden und daher nicht migriert werden können, werden aus diesem Artikel ausgeschlossen.The article excludes project types that are no longer supported in Visual Studio 2017 and cannot therefore be migrated. Außerdem werden auch unterstützte Projekttypen ausgeschlossen, die keine Migrationsprobleme aufweisen. Eine Liste finden Sie unter Zielplattformen und Kompatibilität.The article also excludes supported project types that have no migration issues; that list is found on Platform Targeting and Compatibility.

Important

Bestimmte Projekttypen erfordern die durch den Visual Studio-Installer installierten Workloads.Certain project types require installing the appropriate workloads through the Visual Studio installer. Wenn die Workload nicht installiert ist, meldet Visual Studio einen unbekannten oder nicht kompatiblen Projekttyp.If you don't have the workload installed, Visual Studio reports an unknown or incompatible project type. Überprüfen Sie in einem solchen Fall Ihre Installationsoptionen, und versuchen Sie es dann erneut.In that case, check your installation options and try again. Ausführliche Informationen zur Projektunterstützung in Visual Studio 2017 finden Sie ebenfalls im Artikel Visual Studio 2017 – Zielplattformen und Kompatibilität.Again, see the Platform Targeting and Compatibility article for details on project support in Visual Studio 2017.

ProjekttypenProject types

In der folgenden Liste wird die Unterstützung in Visual Studio 2017 für Projekte beschrieben, die in früheren Versionen erstellt wurden.The following list describes support in Visual Studio 2017 for projects that were created in earlier versions.

Wenn ein Projekt oder ein Dateityp nicht aufgelistet wird, das vorhanden sein sollte, schlagen Sie im Artikel zu Visual Studio 2015 nach, und verwenden Sie die Option „Give documentation feedback“ (Feedback zur Dokumentation geben) am unteren Rand der Seite, um die Details zu Ihrem Projekt bereitzustellen.If you don't see a project or file type listed here that should be, consult the Visual Studio 2015 version of this article and use the "Give documentation feedback" option at the bottom of this page to provide details of your project. (Wenn Sie eine Antwort möchten, verwenden Sie das Feedback zur Dokumentation anstelle des anonymen Steuerelements „Ist diese Seite hilfreich?“(If you'd like a response, use the documentation feedback rather than the anonymous "Is this page helpful?" )control.)

ProjekttypType of Project UnterstützungSupport
.NET Core-Projekte (XPROJ).NET Core projects (xproj) Mit Visual Studio 2015 erstellte Projekte verwendeten die Vorschautools, die eine XPROJ-Projektdatei enthielten.Projects created with Visual Studio 2015 used preview tooling that included an xproj project file. Wenn Sie eine XPROJ-Datei mit Visual Studio 2017 öffnen, werden Sie dazu aufgefordert, die Datei zum CSPROJ-Format zu migrieren (hierbei wird eine Sicherung der XPROJ-Datei erstellt).When you open an xproj file with Visual Studio 2017, you are prompted to migrate the file to the csproj format (a backup of the xproj file is made). Das CSPROJ-Format für .NET Core-Projekte wird in Visual Studio 2015 und früheren Versionen nicht unterstützt.This csproj format for .NET Core projects is not supported in Visual Studio 2015 and earlier. Das XPROJ-Format wird in Visual Studio 2017 nur für die Migration zum CSPROJ-Format unterstützt.The xproj format is not supported in Visual Studio 2017 other than for migration to csproj. Weitere Informationen finden Sie unter Migrieren von .NET Core-Projekten in das CSPROJ-Format.For more information, see Migrating .NET Core projects to the csproj format.
ASP.NET-Webanwendung und ASP.NET Core-Webanwendung mit Application Insights aktiviertASP.NET Web Application and ASP.NET Core Web Application with Application Insights enabled Für jeden Visual Studio-Benutzer wird die Ressourceninformation pro Benutzerinstanz in der Registrierung gespeichert.For each Visual Studio user, resource information is stored in the registry per user instance. Diese Informationen werden verwendet, wenn ein Benutzer kein Projekt geöffnet hat und Azure Application Insights-Daten durchsuchen möchte.This information is used when a user doesn't have a project opened and wants to search Azure Application Insights data. Visual Studio 2015 verwendet andere Registrierungsorte als Visual Studio 2017 und führt so zu keinem Konflikt.Visual Studio 2015 uses different registry location than Visual Studio 2017 and does not conflict.

Sobald ein Benutzer eine ASP.NET-Webanwendung oder eine ASP.NET Core-Webanwendung erstellt, wird die Ressource in der SUO-Datei gespeichert.Once a user creates an ASP.NET Web Application or ASP.NET Core Web Application, the resource is stored in the .suo file. Der Benutzer kann das Projekt in Visual Studio 2015 oder 2017 öffnen. Die Ressourceninformationen werden verwendet, solange Visual Studio Projekte unterstützt und Projektmappen in beiden Versionen verwendet werden.The user can open the project in Visual Studio 2015 or 2017 and the resource information is used for both as long as Visual Studio supports projects and solutions being used across both versions. Benutzer müssen sich einmal für jedes Produkt authentifizieren.Users need to authenticate once on each product. Wenn ein Projekt beispielsweise mit Visual Studio 2015 erstellt und in Visual Studio 2017 geöffnet wird, muss der Benutzer sich für Visual Studio 2017 authentifizieren.For example, if a project is created with Visual Studio 2015 and opened in Visual Studio 2017, the user needs to authenticate on Visual Studio 2017.
C#/Visual Basic Webform oder Windows FormC#/Visual Basic Webform or Windows Form Sie können das Projekt in Visual Studio 2017 und Visual Studio 2015 öffnen.You can open the project in Visual Studio 2017 and Visual Studio 2015.
Datenbankkomponententest-Projekte (CSPROJ, VBPROJ)Database Unit Test Projects (csproj, .vbproj) Ältere Projekte für Datenkomponententests werden in Visual Studio 2017 geladen, verwenden jedoch die GAC-Version der abhängigen Komponenten.Older Data Unit test projects are loaded in Visual Studio 2017 but use the GAC'd version of dependencies. 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.To upgrade the unit test project to use the latest dependencies, right-click on the project in Solution Explorer and select Convert to SQL Server Unit Testing Project....
F#F# Visual Studio 2017 kann Projekte öffnen, die in Visual Studio 2013 und 2015 erstellt wurden.Visual Studio 2017 can open projects created in Visual Studio 2013 and 2015. Um jedoch Visual Studio 2017-Features in diesen Projekten zu aktivieren, öffnen Sie die Projekteigenschaften, und ändern Sie das Ziel „fsharp.core“ zu „F# 4.1“.To enable Visual Studio 2017 features in these projects, however, open the project properties and change target fsharp.core to F# 4.1. Beachten Sie auch, dass die Sprachunterstützung für F# im Visual Studio-Installationsprogramm für .NET-Arbeitsauslastungen nicht standardmäßig ausgewählt ist. Sie müssen diese Option für jede Arbeitslast oder unter Entwicklungsaktivitäten auf der Registerkarte Einzelne Komponenten auswählen.Note also that the F# language support option in the Visual Studio installer is not selected by default with .NET workloads; you must include it by selecting that option for the workload, or selecting it from the Individual components tab under Development activities.
InstallShieldInstallShield
MSI-SetupMSI setup
In Visual Studio 2010 erstellte Installer-Projekte können mithilfe der Visual Studio Installer Projects-Erweiterung in höheren Versionen geöffnet werden.Installer projects created in Visual Studio 2010 can be opened in later versions with the help of the Visual Studio Installer Projects extension. Weitere Informationen finden Sie auch unter WiX Toolset Visual Studio 2017 Extension (Visual Studio 2017-Erweiterung WiX Toolset).Also see the WiX Toolset Visual Studio 2017 Extension. InstallShield Limited Edition ist nicht mehr in Visual Studio enthalten.InstallShield Limited Edition is no longer included with Visual Studio. Schauen Sie sich unter Flexera Software um, um mehr über die Verfügbarkeit für Visual Studio 2017 zu erfahren.Check with Flexera Software about availability for Visual Studio 2017.
LightSwitchLightSwitch LightSwitch wird in Visual Studio 2017 nicht mehr unterstützt.LightSwitch is no longer supported in Visual Studio 2017. 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.Projects created with Visual Studio 2012 and earlier opened in Visual Studio 2013 or Visual Studio 2015 are upgraded and can be opened only in Visual Studio 2013 or Visual Studio 2015 thereafter.
Microsoft Azure-Tools für Visual StudioMicrosoft Azure Tools for 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.To open these types of projects, first install the Azure SDK for .NET, then open the project. Bei Bedarf wird Ihr Projekt aktualisiert.If necessary, your project is updated.
Model View Controller-Framework (ASP.NET MVC)Model-View-Controller framework (ASP.NET MVC) Unterstützung für MVC-Versionen und Visual Studio:Support for MVC versions and Visual Studio:
  • Visual Studio 2010 SP1 unterstützt MVC 2 und MVC 3. Die MVC 4-Unterstützung wird durch den Download von ASP.NET 4 MVC 4 für Visual Studio 2010 SP1 hinzugefügt.Visual Studio 2010 SP1 supports MVC 2 and MVC 3; MVC 4 support is added through the ASP.NET 4 MVC 4 for Visual Studio 2010 SP1 download
  • Visual Studio 2012 unterstützt nur MVC 3 und MVC 4Visual Studio 2012 supports only MVC 3 and MVC 4
  • Visual Studio 2013 unterstützt nur MVC 4 und MVC 5Visual Studio 2013 supports only MVC 4 and MVC 5
  • Visual Studio 2017 und Visual Studio 2015 unterstützen MVC 4 (Sie können vorhandene Projekte öffnen, jedoch keine neuen erstellen) und MVC 5Visual Studio 2017 and Visual Studio 2015 supports MVC 4 (you can open existing projects but not create new ones) and MVC 5

Upgraden der MVC-Versionen:Upgrading MVC versions:
ModellierungModeling 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.If you allow Visual Studio to update the project automatically, you can open it in Visual Studio 2015, Visual Studio 2013, or Visual Studio 2012.

Das Format des Modellierungsprojekts hat sich zwischen Visual Studio 2015 und Visual Studio 2017 nicht verändert. Das Projekt kann in beiden Versionen geöffnet und verändert werden.The format of the modeling project has not changed between Visual Studio 2015 and Visual Studio 2017 and the project can be opened and modified in either version. Es gibt jedoch Unterschiede im Verhalten in Visual Studio 2017:However, there are differences in behavior in Visual Studio 2017:
  • Modellierungsprojekte werden jetzt in den Menüs und Vorlagen als „Abhängigkeitsüberprüfungsprojekte“ bezeichnet.Modeling projects are now referred to as "Dependency Validation" projects in the menus and templates.
  • UML-Diagramme werden in Visual Studio 2017 nicht mehr unterstützt.UML diagrams are no longer supported in Visual Studio 2017. UML-Dateien sind weiterhin in Projektmappen-Explorer aufgelistet, werden jedoch als XML-Dateien geöffnet.UML files are listed in the Solution Explorer as before but are opened as XML files. Verwenden Sie Visual Studio 2015, um UML-Diagramme anzuzeigen, zu erstellen oder zu bearbeiten.Use Visual Studio 2015 to view, create, or edit UML diagrams.
  • In Visual Studio 2017 wird die Überprüfung der Architekturabhängigkeiten nicht länger durchgeführt, wenn das Modellierungsprojekt erstellt wird.In Visual Studio 2017, validation of architectural dependencies is no longer performed when the modeling project is built. Stattdessen wird die Überprüfung ausgeführt, wenn jedes Codeprojekt erstellt wird.Instead, validation is carried out as each code project is built. Diese Änderung wirkt sich nicht auf das Modellierungsprojekt aus, es erfordert jedoch, dass die Änderungen an den Codeprojekten überprüft werden.This change does not affect the modeling project, but it does require changes to the code projects being validated. Visual Studio 2017 kann automatisch die nötigen Änderungen an den Codeprojekten vornehmen (weitere Informationen).Visual Studio 2017 can automatically make the necessary changes to the code projects (more information).
MSI-Setup (VDPROJ)MSI Setup (vdproj) Siehe InstallShield-Projekte.See InstallShield Projects.
Office 2007 VSTOOffice 2007 VSTO Ein unidirektionales Upgrade für Visual Studio 2017 ist erforderlich.Requires a one-way upgrade for Visual Studio 2017.
Office 2010 VSTOOffice 2010 VSTO Wenn das Projekt auf .NET Framework 4 abzielt, können Sie es in Visual Studio 2010 SP1 und höher öffnen.If the project targets the .NET Framework 4, you can open it in Visual Studio 2010 SP1 and later. Alle anderen Projekte erfordern ein unidirektionales Upgrade.All other projects require a one-way upgrade.
Service Fabric (SFPROJ)Service Fabric (sfproj) Service Fabric-Anwendungsprojekte können entweder in Visual Studio 2015 oder in Visual Studio 2017 geöffnet werden, sofern das Service Fabric-Anwendungsprojekt nicht auf ein ASP.NET Core-Dienstprojekt verweist.Service Fabric Application projects can be opened in either Visual Studio 2015 or Visual Studio 2017, unless the Service Fabric Application project references an ASP.NET Core service project. Service Fabric-Projekte aus Visual Studio 2015, die in Visual Studio 2017 geöffnet werden, werden unidirektional vom XPROJ-Format in das CSPROJ-Format migriert.Service Fabric projects from Visual Studio 2015 that are opened in Visual Studio 2017 are one-way migrated from the xproj format to csproj. Siehe „.NET Core-Projekte (XPROJ)“ weiter oben in dieser Tabelle.See ".NET Core projects (xproj)" earlier in this table.
SharePoint 2010SharePoint 2010 Wenn ein SharePoint-Projektmappenprojekt mit Visual Studio 2017 geöffnet wird, wird es entweder auf SharePoint 2013 oder SharePoint 2016 aktualisiert.When a SharePoint solution project is opened with Visual Studio 2017, it's upgraded to either SharePoint 2013 or SharePoint 2016. Die Arbeitsauslastung „.NET-Desktopentwicklung“ muss für das Upgrade in Visual Studio 2017 installiert werden.The ".NET Desktop Development" workload must be installed in Visual Studio 2017 for the upgrade.

Weitere Informationen zum Aktualisieren von SharePoint-Projekten finden Sie unter Upgrade auf SharePoint 2013, Aktualisieren von Workflows in SharePoint Server 2013 und Erstellen einer SharePoint 2016-Farm für ein Upgrade einer Datenbankanfügung.For more information about how to upgrade SharePoint projects, see Upgrade to SharePoint 2013, Update Workflow in SharePoint Server 2013, and Create the SharePoint Server 2016 farm for a database attach upgrade.
SharePoint 2016SharePoint 2016 In Office Developer Tools Preview 2 erstellte SharePoint-Add-In-Projekte können nicht in Visual Studio 2017 geöffnet werden.SharePoint Add-In projects created in Office Developer Tools Preview 2 cannot be opened in Visual Studio 2017. 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.To work around this limitation, update the MinimumVisualStudioVersion to 12.0 and MinimumOfficeToolsVersion to 12.2 in the csproj vbproj file.
SilverlightSilverlight Silverlight-Projekte werden in Visual Studio 2017 nicht unterstützt.Silverlight projects not supported in Visual Studio 2017. Um Silverlight-Anwendungen zu verwalten, verwenden Sie weiterhin Visual Studio 2015.To maintain Silverlight applications, continue to use Visual Studio 2015.
SQL Server Reporting Services und SQL Server Analysis Services (SSRS, SSDT, SSAS, MSAS)SQL Server Reporting Services and SQL Server Analysis Services (SSRS, SSDT, SSAS, MSAS) Unterstützung für diese Projekttypen wird über zwei Erweiterungen in der Visual Studio Gallery bereitgestellt: Microsoft Analysis Services-Modellierungsprojekte und Microsoft Reporting Services-Projekte.Support for these project types is provided through two extensions in the Visual Studio Gallery: Microsoft Analysis Services Modeling Projects and Microsoft Reporting Services Projects. SSDT-Unterstützung ist auch in der Arbeitsauslastung für Datenspeicherung und -verarbeitung in Visual Studio 2017 enthalten.SSDT support is also included with the Data Storage and Processing workload in Visual Studio 2017.
SQL Server Integration Services (SSIS)SQL Server Integration Services (SSIS) Die Unterstützung für Visual Studio 2017 ist ebenfalls über SQL Server Data Tools (SSDT) verfügbar.Support for Visual Studio 2017 is available through the SQL Server Data Tools (SSDT). Weitere Informationen finden Sie im Blog zu SQL Server Integration Services.For more information, see the SQL Server Integration Services blog.
Visual C++Visual C++ Sie können Visual Studio 2017 verwenden, um in Projekten zu arbeiten, die in Vorgängerversionen von Visual Studio (zurückgehend bis zu Visual Studio 2010) erstellt wurden.You can use Visual Studio 2017 to work in projects that were created in earlier versions of Visual Studio back to Visual Studio 2010. 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.When you first open the project, you have the option to upgrade to the latest compiler and toolset or to continue using the original ones. Wenn Sie sich dafür entscheiden, weiterhin die ursprünglichen zu verwenden, ändert Visual Studio 2017 die Projektdatei nicht und verwendet das Toolset der früheren Visual Studio-Installation, um Ihr Projekt zu erstellen.If you choose to keep using the original ones, Visual Studio 2017 does not modify the project file, and uses the toolset from the earlier Visual Studio installation to build your project. 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.Keeping the original options means you can still open the project in the original version of Visual Studio if necessary. 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).For more information, see Use native multi-targeting in Visual Studio to build old projects.
Visual Studio-Erweiterbarkeit/VSIXVisual Studio Extensibility/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.Projects with MinimumVersion 14.0 or less are updated to declare MinimumVersion 15.0, which prevents the project from being opened in earlier versions of Visual Studio. Damit Sie ein Projekt in früheren Versionen öffnen können, legen Sie MinimumVersion auf $(VisualStudioVersion) fest.To allow a project to open in earlier versions, set MinimumVersion to $(VisualStudioVersion). Weitere Informationen finden Sie unter Vorgehensweise: Migrieren von Erweiterungsprojekten zu Visual Studio 2017.See also How to: Migrate Extensibility Projects to Visual Studio 2017.
Visual Studio Lab ManagementVisual 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.You can use Microsoft Test Manager or Visual Studio 2010 SP1 and later to open environments created in any of these versions. 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.However, for Visual Studio 2010 SP1 the version of Microsoft Test Manager must match the version of Team Foundation Server before you can create environments.
Visual Studio-Tools für Apache CordovaVisual Studio Tools for Apache Cordova Projekte können in Visual Studio 2017 geöffnet werden, sind aber nicht abwärtskompatibel.Projects can be opened in Visual Studio 2017, but are not backwards compatible. Beim Öffnen eines Projekts von Visual Studio 2015 werden Sie dazu aufgefordert, Änderungen an Ihrem Projekt zuzulassen.Upon opening a project from Visual Studio 2015, you're prompted to allow modifications to your project. Durch diese Änderung wird das Projekt dafür aktualisiert, Toolsets statt einer taco.json-Datei zu verwenden, um die Versionskontrolle der Cordova-Bibliothek, die Plattformen und Plug-Ins sowie die Abhängigkeiten von Knoten und npm zu verwalten.This modification upgrades the project to use toolsets instead of a taco.json file to manage the versioning of the Cordova library, its platforms, its plugins, and its node/npm dependencies. Weitere Informationen finden Sie im Migrationshandbuch.See the migration guide for more information.
Webbereitstellung (WDPROJ)Web Deployment (wdproj) Die Unterstützung für Webbereitstellungsprojekte wurde mit Einführung der Unterstützung für Veröffentlichungsprofile in Visual Studio 2012 eingestellt.Support for Web Deployment projects was removed in Visual Studio 2012 with the addition of publish profile support. Da in Visual Studio 2017 kein Äquivalent zur Verfügung steht, ist kein automatischer Migrationspfad für diese Projekte vorhanden.Because there is no equivalent in Visual Studio 2017, there is no automatic migration path for such projects. Ö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.Instead, open the wdproj file in a text editor and copy-paste any customizations into to the pubxml (publish profile) file, as described on StackOverflow. Siehe auch Plans regarding Website projects and Web Deployment Projects (Pläne in Bezug auf Website- und Webbereitstellungsprojekte, MSDN-Blog).Also see Plans regarding website and web deployment projects (MSDN blogs).
Windows Communication Foundation und Windows Workflow FoundationWindows Communication Foundation, Windows Workflow Foundation Sie können dieses Projekt in Visual Studio 2017, Visual Studio 2015, Visual Studio 2013 und Visual Studio 2012 öffnen.You can open this project in Visual Studio 2017, Visual Studio 2015, Visual Studio 2013, and Visual Studio 2012
Windows Presentation FoundationWindows Presentation Foundation Sie können dieses Projekt in Visual Studio 2013, Visual Studio 2012 und Visual Studio 2010 SP1 öffnen.You can open this project in Visual Studio 2013, Visual Studio 2012, and Visual Studio 2010 SP1.
Windows Store/Phone-AppsWindows Store/Phone apps Projekte für Windows Store 8.1 und 8.0 sowie für Windows Phone 8.1 und 8.0 werden in Visual Studio 2017 nicht unterstützt.Projects for Windows Store 8.1 and 8.0, and Windows Phone 8.1 and 8.0 are not supported in Visual Studio 2017. Um diese Apps zu verwalten, verwenden Sie weiterhin Visual Studio 2015.To maintain these apps, continue to use Visual Studio 2015. Zum Verwalten von Windows Phone 7.x-Projekten verwenden Sie Visual Studio 2012.To maintain Windows Phone 7.x projects, use Visual Studio 2012.

Wie Visual Studio über den Zeitpunkt der Migration eines Projekts entscheidetHow Visual Studio decides when to migrate a project

Jede neue Version von Visual Studio versucht in der Regel die Kompatibilität mit früheren Versionen zu erhalten, sodass dasselbe Projekt geöffnet, geändert und in den verschiedenen Versionen erstellt werden kann.Each new version of Visual Studio generally seeks to maintain compatibility with previous versions, such that the same project can be opened, modified, and built across different versions. Es gibt jedoch im Laufe der Zeit unvermeidliche Änderungen, sodass einige Projekttypen möglicherweise nicht mehr unterstützt werden.However, there are inevitable changes over time such that some project types may no longer be supported. (Unter Zielplattformen und Kompatibilität erfahren Sie, welche Projekttypen in Visual Studio 2017 unterstützt werden.) In diesen Fällen lädt eine neuere Version von Visual Studio das Projekt nicht und bietet keinen Migrationspfad an. Sie müssen das Projekt in einer früheren Version von Visual Studio verwalten, die es unterstützt.(See Platform Targeting and Compatibility for which project types are supported in Visual Studio 2017.) In these cases, a newer version of Visual Studio won't load the project and doesn't offer a migration path; you need to maintain that project in a previous version of Visual Studio that does support it.

In anderen Fällen 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.In other cases, the newer version of Visual Studio can open a project, but must update or migrate the project in such a way that might render it incompatible with previous versions. Visual Studio verwendet eine Reihe von Kriterien, um zu bestimmen, ob diese Migration erforderlich ist:Visual Studio uses a number of criteria to determine whether such migration is necessary:

  • Kompatibilität mit den Zielversionen der Plattformen, bis zu Visual Studio 2013 RTM.Compatibility with the target versions of platforms, back to Visual Studio 2013 RTM.

  • Kompatibilität der Entwurfszeitassets mit früheren Versionen von Visual Studio.Compatibility of design-time assets with previous versions of Visual Studio. (D.h. verschiedene Kanäle von Visual Studio 2017, Visual Studio 2015 RTM und Update 3, Visual Studio 2013 RTM und Update 5, Visual Studio 2012 Update 4, Visual Studio 2010 SP1.) Visual Studio 2017 zielt darauf ab, ordnungsgemäß mit veralteten Entwurfszeitassets fehlzuschlagen, ohne sie zu beschädigen, sodass frühere Versionen das Projekt immer noch öffnen können.(Namely different channels of 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 2017 aims to fail gracefully with deprecated design-time assets without corrupting them, such that previous versions can still open the project.

  • Ob die neuen Entwurfszeitassets die Kompatibilität mit vorherigen Versionen bis Visual Studio 2013 RTM & Update 5 beeinträchtigen.Whether new design time assets would break compatibility with previous versions down to Visual Studio 2013 RTM & Update 5.

Der Entwicklungsbesitzer des betreffenden Projekttyps prüft diese Kriterien und führt den Aufruf für Support, Kompatibilität und Migration durch.The engineering owner of the project type in question looks at these criteria and makes the call where support, compatibility, and migration are concerned. Visual Studio versucht, wenn möglich, eine transparente Kompatibilität zwischen verschiedenen Versionen von Visual Studio beizubehalten. Dies bedeutet, dass Projekte in einer Version von Visual Studio erstellt und geändert werden können und in anderen Versionen genauso funktionieren.Again, Visual Studio tries to maintain transparent compatibility between Visual Studio versions if possible, meaning that one can create and modify projects in one version of Visual Studio and it just works in other versions.

Wenn eine solche Kompatibilität nicht möglich ist, wie es für einige in diesem Artikel beschriebenen Projekttypen der Fall ist, öffnet Visual Studio den Upgrade-Assistenten, um die erforderlichen unidirektionalen Änderungen vorzunehmen.If such compatibility is not possible, however, as with some of the project types described in this article, then Visual Studio opens the upgrade wizard to make the necessary one-way changes.

Solche 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 letztlich benötigen.Such one-way changes may involve changing the ToolsVersion property in the project file, which denotes exactly which version of MSBuild can turn the project's source code into runnable and deployable artifacts that you ultimately want. Das heißt, dass ein Projekt aufgrund der MSBuild-Version gemäß ToolsVersion und nicht aufgrund der Visual Studio-Version nicht mit früheren Versionen von Visual Studio kompatibel ist.That is, what renders a project incompatible with previous versions of Visual Studio is not the Visual Studio version, but the MSBuild version, as determined by ToolsVersion. Solange 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.So long as your version of Visual Studio contains the MSBuild toolchain that matches the ToolsVersion in a project, then Visual Studio can invoke that toolchain to build the project.

Um maximale Kompatibilität mit den in früheren Versionen erstellten Projekten zu gewährleisten, enthält Visual Studio 2017 die erforderlichen MSBuild-Toolketten zur Unterstützung der ToolsVersion 15, 14, 12 und 4.To maintain maximum compatibility with projects created in older versions, Visual Studio 2017 includes the necessary MSBuild toolchains to support ToolsVersion 15, 14, 12, and 4. Projekte, die diese ToolsVersion-Werte verwenden, sollten zu einem erfolgreichen Build führen.Projects that use any of these ToolsVersion values should result in a successful build. (Abhängig von der Tatsache, ob Visual Studio 2017 den Projekttyp überhaupt unterstützt, wie in Zielplattformen und Kompatibilität beschrieben.)(Subject, again, to whether Visual Studio 2017 supports the project type at all, as described on Platform Targeting and Compatibility.)

In diesem Kontext stellt sich natürlich die Frage, ob versucht werden soll, ein Projekt manuell auf einen neueren ToolsVersion-Wert zu aktualisieren oder zu migrieren.In this context, the question naturally arises whether you should try to manually update or migrate a project to a newer ToolsVersion value. 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.Making such a change is unnecessary, and would likely generate many errors and warnings that you'd need to fix to get the project to build again. Wenn Visual Studio darüber hinaus die Unterstützung für eine bestimmte ToolsVersion in Zukunft beendet, löst das Öffnen des Projekts den Migrationsvorgang des Projekts aus, da der ToolsVersion-Wert geändert werden muss.Furthermore, if Visual Studio drops support for a specific ToolsVersion in the future, then opening the project will trigger the project migration process specifically because the ToolsVersion value must be changed. In einem solchen Fall weiß das Subsystem für diesen bestimmten Projekttyp genau, was geändert werden muss, und kann diese Änderungen automatisch durchführen, wie weiter oben in diesem Artikel beschrieben wurde.In such a case, the subsystem for that specific project type knows exactly what needs to be changed, and can make those changes automatically as described earlier in this article.

In den folgenden Artikeln finden Sie weitere Erläuterungen:Refer to the following articles for further discussion: