Portar, migrar y actualizar proyectos de Visual StudioPort, Migrate, and Upgrade Visual Studio Projects

Cada nueva versión de Visual Studio suele ser compatible con la mayoría de los tipos anteriores de proyectos, archivos y otros activos.Each new version of Visual Studio generally supports most previous types of projects, files, and other assets. Puede trabajar con ellos igual que ha hecho hasta ahora, y siempre y cuando no dependa de las características más recientes, Visual Studio mantendrá la compatibilidad con versiones anteriores, como Visual Studio 2015, Visual Studio 2013 y Visual Studio 2012.You can work with them as you always have, and provided that you don't depend on newer features, Visual Studio preserves backwards compatibility with previous versions like Visual Studio 2015, Visual Studio 2013, and Visual Studio 2012. (Vea en Notas de la versión las funciones específicas de cada versión).(See the Release Notes for which features are specific to which versions.)

A pesar de todo, la compatibilidad con algunos tipos de proyecto puede cambiar a lo largo del tiempo.Support for some project types change over time, however. Una versión más reciente de Visual Studio podría no admitir ciertos tipos o requerir que se migren y se actualicen, de forma que ya no serán compatibles con versiones anteriores.A newer version of Visual Studio may no longer support certain types, or require that they be migrated and updated such that they're no longer backwards-compatible. Para obtener información actualizada sobre los problemas de migración, vea el sitio de la comunidad para desarrolladores de Visual Studio.For current status on migration issues, refer to the Visual Studio Developer Community site.

Importante

El presente artículo proporciona información solo para los tipos de proyectos de Visual Studio 2017 que implican migración.This present article provides details only for project types in Visual Studio 2017 that involve migration. No incluye tipos de proyectos compatibles que no tienen problemas de migración. Esa lista se encuentra en Compatibilidad y destinatarios de la plataforma de Visual Studio 2017.It does not include supported project types that have no migration issues; that list is found on Platform Targeting and Compatibility. Tenga en cuenta también que algunos tipos de proyectos ya no se admiten en Visual Studio 2017 y, por lo tanto, no pueden migrarse.Note also that some project types are no longer supported in Visual Studio 2017 at all and therefore cannot be migrated.

Importante

Para abrir determinados tipos de proyectos, es necesario agregar las cargas de trabajo adecuadas en el instalador de Visual Studio.Adding appropriate workloads in the Visual Studio installer is necessary for opening certain project types. Si no tiene la carga de trabajo instalada, Visual Studio notifica que se trata de un tipo de proyecto incompatible o desconocido.If you don't have the workload installed, Visual Studio reports an unknown or incompatible project type. En ese caso, compruebe sus opciones de instalación y vuelva a intentarlo.In that case, check your installation options and try again. De nuevo, vea el artículo Compatibilidad y destinatarios de la plataforma de Visual Studio 2017 para obtener información sobre la compatibilidad de proyectos en Visual Studio 2017.Again, see the Platform Targeting and Compatibility article for details on project support in Visual Studio 2017.

ProyectosProjects

En la lista siguiente se describe la compatibilidad de Visual Studio 2017 con proyectos creados en versiones anteriores.The following list describes support in Visual Studio 2017 for projects that were created in earlier versions.

Si no encuentra un tipo de archivo o proyecto que debería mostrarse, consulte la versión de Visual Studio 2015 de este artículo y use la opción "Enviar comentarios de la documentación" al final de la página para proporcionar detalles de sus proyecto.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.

Tipo de proyectoType of Project CompatibilidadSupport
Proyectos de .NET Core (.xproj).NET Core projects (.xproj) Los proyectos creados con Visual Studio 2015 usaban las herramientas de vista previa, que incluían un archivo de proyecto.xproj.Projects created with Visual Studio 2015 used preview tooling that included a .xproj project file. Cuando abra un archivo .xproj con Visual Studio 2017, se le pedirá que migre el archivo al formato .csproj (se realiza una copia de seguridad del archivo .xproj).When you open a .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). Este formato .csproj para los proyectos de .NET Core no se admite en VS2015 y versiones anteriores.This .csproj format for .NET Core projects is not supported in VS2015 and earlier. El formato .xproj no se admite en Visual Studio 2017, a menos que sea para la migración a .csproj.The .xproj format is not supported in Visual Studio 2017 other than for migration to .csproj. Para más información, consulte Migración de proyectos de .NET Core al formato .csproj.For more information, see Migrating .NET Core projects to the .csproj format.
Aplicación web ASP.NET y aplicación web ASP.NET Core con Application Insights habilitadoASP.NET Web Application and ASP.NET Core Web Application with Application Insights enabled Para cada usuario de Visual Studio, la información de los recursos se almacena en el Registro por instancia de usuario.For each Visual Studio user, resource information is stored in the registry per user instance. Se usa cuando un usuario no tiene abierto un proyecto y quiere buscar datos de Azure Application Insights.This is used when a user doesn't t have a project opened and wants to search Azure Application Insights data. Visual Studio 2015 usa una ubicación del Registro diferente de la de Visual Studio 2017 y no entra en conflicto.Visual Studio 2015 uses different registry location than Visual Studio 2017 and does not conflict.

Una vez que un usuario crea una aplicación web ASP.NET o una aplicación web ASP.NET Core, el recurso se almacena en el archivo .suo.Once a user creates an ASP.NET Web Application or ASP.NET Core Web Application, the resource is stored in the .suo file. El usuario puede abrir el proyecto en Visual Studio 2015 o 2017 y la información de los recursos se usa para ambos, siempre y cuando Visual Studio sea compatible con los proyectos y las soluciones que se usan en las dos versiones.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. Los usuarios deben autenticarse una vez en cada producto.Users need to authenticate once on each product. Por ejemplo, si un proyecto se ha creado con Visual Studio 2015 y se abre en Visual Studio 2017, el usuario debe autenticarse en Visual Studio 2017.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.
Webform o Windows Forms de C#/Visual BasicC#/Visual Basic Webform or Windows Form Puede abrir el proyecto en Visual Studio 2017 y Visual Studio 2015.You can open the project in Visual Studio 2017 and Visual Studio 2015.
Proyectos de prueba unitaria de base de datos (.csproj, .vbproj)Database Unit Test Projects (.csproj, .vbproj) Los proyectos de prueba unitaria de datos más antiguos se cargan en Visual Studio 2017, pero usan la versión con GAC de las dependencias.Older Data Unit test projects are loaded in Visual Studio 2017 but use the GAC’d version of dependencies. Para actualizar el proyecto de prueba unitaria de modo que use las dependencias más recientes, haga clic con el botón derecho en el proyecto en el Explorador de soluciones y seleccione Convertir en proyecto de prueba unitaria de SQL Server….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 puede abrir proyectos creados en Visual Studio 2013 y 2015.Visual Studio 2017 can open projects created in Visual Studio 2013 and 2015. Para habilitar las características de Visual Studio 2017 en estos proyectos, abra las propiedades del proyecto y cambie el destino fsharp.core a 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. Tenga en cuenta también que la opción Compatibilidad con el lenguaje F# en el instalador de Visual Studio no está seleccionada de manera predeterminada con cargas de trabajo de .NET; debe incluirla seleccionando esa opción para la carga de trabajo o seleccionándola desde la pestaña Componentes individuales en Actividades de desarrollo.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
Programa de instalación de MSIMSI setup
Los proyectos de instalador creados en Visual Studio 2010 se pueden abrir en versiones posteriores con la ayuda de la extensión de proyectos del instalador de Visual Studio.Installer projects created in Visual Studio 2010 can be opened in later versions with the help of the Visual Studio Installer Projects extension. También puede ver la extensión de Visual Studio 2017 para WiX Toolset.Also see the WiX Toolset Visual Studio 2017 Extension. InstallShield Limited Edition ya no se incluye con Visual Studio.InstallShield Limited Edition is no longer included with Visual Studio. Consulte con Flexera Software la disponibilidad para Visual Studio 2017.Check with Flexera Software about availability for Visual Studio 2017.
LightSwitchLightSwitch LightSwitch ya no se admite en Visual Studio 2017.LightSwitch is no longer supported in Visual Studio 2017. Los proyectos creados con Visual Studio 2012 y versiones anteriores que se abran en Visual Studio 2013 o Visual Studio 2015 se actualizarán y solo se podrán abrir en Visual Studio 2013 o Visual Studio 2015 a partir de entonces.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 para Visual StudioMicrosoft Azure Tools for Visual Studio Para abrir estos tipos de proyecto, instale primero el SDK de Azure para .NETy luego abra el proyecto.To open these types of projects, first install the Azure SDK for .NET, then open the project. Si es necesario, el proyecto se actualizará.If necessary, your project is updated.
Marco de trabajo Model-View-Controller (ASP.NET MVC)Model-View-Controller framework (ASP.NET MVC) Compatibilidad con versiones de MVC y Visual Studio:Support for MVC versions and Visual Studio:
  • Visual Studio 2010 SP1 admite MVC 2 y MVC 3. Se ha agregado compatibilidad con MVC 4 mediante la descarga de ASP.NET 4 MVC 4 para Visual Studio 2010 SP1.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 solo admite MVC 3 y MVC 4.Visual Studio 2012 supports only MVC 3 and MVC 4
  • Visual Studio 2013 solo admite MVC 4 y MVC 5.Visual Studio 2013 supports only MVC 4 and MVC 5
  • Visual Studio 2017 y Visual Studio 2015 admiten MVC 4 (puede abrir proyectos existentes, pero no crearlos) y MVC 5.Visual Studio 2017 and Visual Studio 2015 supports MVC 4 (you can open existing projects but not create new ones) and MVC 5


Actualización de versiones de MVC:Upgrading MVC versions:
ModeladoModeling Si permite que Visual Studio actualice el proyecto automáticamente, puede abrirlo en Visual Studio 2015, Visual Studio 2013 o Visual Studio 2012.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.

El formato del proyecto de modelado no ha cambiado entre Visual Studio 2015 y Visual Studio 2017, y el proyecto se puede abrir y modificar en cualquier versión.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. A pesar de todo, existen diferencias en el comportamiento de Visual Studio 2017:However, there are differences in behavior in Visual Studio 2017:
  • Los proyectos de modelado ahora se denominan proyectos de "Validación de dependencias" en los menús y las plantillas.Modeling projects are now referred to as "Dependency Validation" projects in the menus and templates.
  • Los diagramas UML ya no se admiten en Visual Studio 2017.UML diagrams are no longer supported in Visual Studio 2017. Los archivos UML se muestran en el Explorador de soluciones igual que antes, pero se abrirán como archivos XML.UML files are listed in the Solution Explorer as before but are opened as XML files. Use Visual Studio 2015 para ver, crear o editar los diagramas UML.Use Visual Studio 2015 to view, create, or edit UML diagrams.
  • En Visual Studio 2017, la validación de dependencias arquitectónicas ya no se lleva a cabo cuando se compila el proyecto de modelado,In Visual Studio 2017, validation of architectural dependencies is no longer performed when the modeling project is built. sino que se realiza a medida que se compila cada proyecto de código.Instead, validation is carried out as each code project is built. Este cambio no afecta al proyecto de modelado, pero requiere una serie de cambios en los proyectos de código que se están validando.This change does not affect the modeling project, but it does require changes to the code projects being validated. Visual Studio 2017 puede realizar automáticamente los cambios necesarios en los proyectos de código (más información).Visual Studio 2017 can automatically make the necessary changes to the code projects (more information).
Programa de instalación de MSI (.vdproj)MSI Setup (.vdproj) Vea proyectos de InstallShield anteriores.See InstallShield Projects above.
Office 2007 VSTOOffice 2007 VSTO Requiere una actualización unidireccional para Visual Studio 2017.Requires a one-way upgrade for Visual Studio 2017.
Office 2010 VSTOOffice 2010 VSTO Si el proyecto tiene como destino .NET Framework 4, puede abrirlo en Visual Studio 2010 SP1 y posterior.If the project targets the .NET Framework 4, you can open it in Visual Studio 2010 SP1 and later. Todos los demás proyectos requieren una actualización unidireccional.All other projects require a one-way upgrade.
SharePoint 2010SharePoint 2010 Cuando se abra un proyecto de solución de SharePoint con Visual Studio 2017, se actualizará a SharePoint 2013 o SharePoint 2016.When a SharePoint solution project is opened with Visual Studio 2017, it's upgraded to either SharePoint 2013 or SharePoint 2016. La carga de trabajo "Desarrollo de escritorio de .NET" debe instalarse en Visual Studio 2017 para la actualización.The ".NET Desktop Development" workload must be installed in Visual Studio 2017 for the upgrade.

Para más información sobre cómo actualizar proyectos de SharePoint, vea Actualizar a SharePoint 2013, Actualizar flujo de datos en SharePoint Server 2013 y Crear la granja de servidores de SharePoint Server 2016 para una actualización de agregación de base de datos.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 Los proyectos Complemento de SharePoint creados en Office Developer Tools Preview 2 no se puede abrir en Visual Studio 2017.SharePoint Add-In projects created in Office Developer Tools Preview 2 cannot be opened in Visual Studio 2017. Como solución alternativa a esta limitación, actualice MinimumVisualStudioVersion a 12.0 y MinimumOfficeToolsVersion a 12.2 en el archivo .csproj o .vbproj.To work around this limitation, update the MinimumVisualStudioVersion to 12.0 and MinimumOfficeToolsVersion to 12.2 in the .csproj or .vbproj file.
SilverlightSilverlight Los proyectos de Silverlight no se admiten en Visual Studio 2017.Silverlight projects not supported in Visual Studio 2017. Para conservar las aplicaciones de Silverlight, siga usando Visual Studio 2015.To maintain Silverlight applications, continue to use Visual Studio 2015.
SQL Server Reporting Services y SQL Server Analysis Services (SSRS, SSDT, SSAS, MSAS)SQL Server Reporting Services and SQL Server Analysis Services (SSRS, SSDT, SSAS, MSAS) La compatibilidad con estos tipos de proyectos se proporciona mediante dos extensiones en la Galería de Visual Studio: Proyectos de modelado de Microsoft Analysis Services y Proyectos de Microsoft Reporting Services.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. También se incluye la compatibilidad de SSDT con el almacenamiento de datos y la carga de trabajo de procesamiento en Visual Studio 2017.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) La compatibilidad con Visual Studio 2017 está disponible mediante SQL Server Data Tools (SSDT).Support for Visual Studio 2017 is available through the SQL Server Data Tools (SSDT). Para obtener más información, consulte el blog de SQL Server Integration Services.For more information, see the SQL Server Integration Services blog.
Visual C++Visual C++ Puede usar Visual Studio 2017 para abrir soluciones y proyectos creados en Visual Studio 2015 sin cambios.You can use Visual Studio 2017 to open solutions and projects that were created in Visual Studio 2015 as-is. Los proyectos creados en versiones anteriores de Visual Studio pueden requerir la actualización del proyecto o la redestinación a un conjunto de herramientas más reciente para compilar con Visual Studio 2017.Projects created in older versions of Visual Studio may require upgrading the project or retargeting to a more recent toolset to build with Visual Studio 2017. Para obtener más información, consulte la Guía de migración y actualización de Visual C++.For more information, see Visual C++ Porting and Upgrading Guide.
Extensibilidad de Visual Studio/VSIXVisual Studio Extensibility/VSIX Los proyectos con MinimumVersion 14.0 o menos se actualizarán para que declaren MinimumVersion 15.0, lo que impide que el proyecto se abra en versiones anteriores de Visual Studio.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. Para permitir que un proyecto se abra en versiones anteriores, establezca MinimumVersion en $(VisualStudioVersion).To allow a project to open in earlier versions, set MinimumVersion to $(VisualStudioVersion). Vea también How to: Migrate Extensibility Projects to Visual Studio 2017 (Cómo: Migrar proyectos de extensibilidad a Visual Studio 2017).See also How to: Migrate Extensibility Projects to Visual Studio 2017.
Visual Studio Lab ManagementVisual Studio Lab Management Puede usar Microsoft Test Manager o Visual Studio 2010 SP1 y versiones posteriores para abrir entornos creados en cualquiera de estas versiones.You can use Microsoft Test Manager or Visual Studio 2010 SP1 and later to open environments created in any of these versions. En el caso de Visual Studio 2010 SP1, la versión de Microsoft Test Manager debe coincidir con la versión de Team Foundation Server para poder crear entornos.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 para Apache CordovaVisual Studio Tools for Apache Cordova Los proyectos se pueden abrir en Visual Studio 2017, pero no son compatibles con versiones anteriores.Projects can be opened in Visual Studio 2017, but it are not backwards compatible. Al abrir un proyecto de Visual Studio 2015, se le pedirá que permita realizar modificaciones en el proyecto.Upon opening a project from Visual Studio 2015, you're prompted to allow modifications to your project. Esta modificación actualiza el proyecto para que use conjuntos de herramientas en lugar de un archivo taco.json para administrar el control de versiones de la biblioteca de Cordova, sus plataformas y complementos, y sus dependencias de nodo/npm.This modification upgrades the project to use toolsets instead of a taco.json file to manage the versioning of the Cordova library, its platforms and plugins, as well as its node/npm dependencies. Vea la guía de migración para obtener más información.See the migration guide for more information.
Windows Communication Foundation y Windows Workflow FoundationWindows Communication Foundation, Windows Workflow Foundation Puede abrir este proyecto en Visual Studio 2017, Visual Studio 2015, Visual Studio 2013 y Visual Studio 2012.You can open this project in Visual Studio 2017, Visual Studio 2015, Visual Studio 2013, and Visual Studio 2012
Windows Presentation FoundationWindows Presentation Foundation Puede abrir este proyecto en Visual Studio 2013, Visual Studio 2012 y Visual Studio 2010 SP1.You can open this project in Visual Studio 2013, Visual Studio 2012, and Visual Studio 2010 SP1.
Aplicaciones de la Tienda Windows/Windows PhoneWindows Store/Phone apps Los proyectos para la Tienda Windows 8.1 y 8.0 y Windows Phone 8.1 y 8.0 no son compatibles con Visual Studio 2017.Projects for Windows Store 8.1 and 8.0, and Windows Phone 8.1 and 8.0 are not supported in Visual Studio 2017. Para conservar estas aplicaciones, siga usando Visual Studio 2015.To maintain these apps, continue to use Visual Studio 2015. Para conservar los proyectos de Windows Phone 7.x, use Visual Studio 2012.To maintain Windows Phone 7.x projects, use Visual Studio 2012.