Referência de migração e atualização de projeto do Visual StudioProject migration and upgrade reference for Visual Studio

Cada versão do Visual Studio geralmente oferece suporte à maioria dos tipos de projetos, arquivos e outros ativos anteriores.Each version of Visual Studio generally supports most previous types of projects, files, and other assets. Você pode trabalhar com eles como sempre tem, e desde que não dependa de recursos mais recentes, o Visual Studio tenta preservar a compatibilidade com versões anteriores, como o visual Studio 2015, o Visual Studio 2013 e o visual Studio 2012.You can work with them as you always have, and provided that you don't depend on newer features, Visual Studio tries to preserve backwards compatibility with previous versions like Visual Studio 2015, Visual Studio 2013, and Visual Studio 2012. (Consulte as Notas de versão para saber quais recursos são específicos a quais versões.)(See the Release Notes for which features are specific to which versions.)

O suporte para alguns tipos de projeto também muda ao longo do tempo.Support for some project types also changes over time. É possível que uma versão mais recente do Visual Studio já não dê mais suporte a determinados projetos ou exija que eles sejam atualizados, fazendo com que eles deixem de ser compatíveis com versões anteriores.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. Para obter o status atual de problemas de migração, consulte o site Developer Community (Comunidade do Desenvolvedor) do Visual Studio.For current status on migration issues, refer to the Visual Studio Developer Community site.

Este artigo fornece detalhes somente para os tipos de projeto que o Visual Studio 2017 pode migrar.This present article provides details only for project types that Visual Studio 2017 can migrate. O artigo exclui os tipos de projeto para os quais não há mais suporte no Visual Studio 2017 e, portanto, não podem ser migrados.The article excludes project types that are no longer supported in Visual Studio 2017 and cannot therefore be migrated. O artigo também exclui os tipos de projeto compatíveis que não têm nenhum problema de migração. A lista desses tipos é encontrada em Direcionamento e compatibilidade da plataforma.The article also excludes supported project types that have no migration issues; that list is found on Platform Targeting and Compatibility.

Importante

Alguns tipos de projeto exigem a instalação das cargas de trabalho apropriadas por meio do instalador do Visual Studio.Certain project types require installing the appropriate workloads through the Visual Studio installer. Se a carga de trabalho não estiver instalada, o Visual Studio relatará um tipo de projeto desconhecido ou incompatível.If you don't have the workload installed, Visual Studio reports an unknown or incompatible project type. Nesse caso, verifique as opções de instalação e tente novamente.In that case, check your installation options and try again. Novamente, consulte o artigo Direcionamento e compatibilidade da plataforma para obter detalhes sobre o suporte de projetos no Visual Studio 2017.Again, see the Platform Targeting and Compatibility article for details on project support in Visual Studio 2017.

Tipos de projetoProject types

A lista a seguir descreve o suporte do Visual Studio 2017 a projetos que foram criados em versões anteriores.The following list describes support in Visual Studio 2017 for projects that were created in earlier versions.

Se não estiver listado aqui um projeto ou um tipo de arquivo que deveria estar, consulte a versão deste artigo para o Visual Studio 2015 e use o botão Fornecer comentários sobre > Esta página na parte inferior desta página para fornecer detalhes do seu projeto.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 Send feedback about > This page button at the bottom of this page to provide details of your project. (Se você usar o controle anônimo "Esta página é útil?",(If you use the anonymous "Is this page helpful?" talvez não sejamos capazes de responder aos seus comentários.)control, we aren't able to respond to your feedback.)

Tipo de projetoType of Project SuporteSupport
Projetos do .NET Core (xproj).NET Core projects (xproj) Projetos criados com o Visual Studio 2015 usavam ferramentas de visualização que incluíam um arquivo de projeto xproj.Projects created with Visual Studio 2015 used preview tooling that included an xproj project file. No Visual Studio 2017, o formato xproj não tem suporte além de ser para migração para o formato csproj.In Visual Studio 2017, the xproj format is not supported other than for migration to csproj format. Ao abrir um arquivo xproj, você será solicitado a migrar o arquivo para o formato csproj do estilo SDK.When you open an xproj file, you're prompted to migrate the file to the SDK-style csproj format. (É feito um backup do arquivo xproj.) Não há suporte para projetos csproj de estilo SDK no Visual Studio 2015 e versões anteriores.(A backup of the xproj file is made.) SDK-style csproj projects are not supported in Visual Studio 2015 and earlier. Para obter mais informações, consulte migrando projetos do .NET Core para o formato csproj.For more information, see Migrating .NET Core projects to the csproj format.
Aplicativo Web ASP.NET e Aplicativo Web ASP.NET Core com o Application Insights habilitadoASP.NET Web Application and ASP.NET Core Web Application with Application Insights enabled Para cada usuário do Visual Studio, as informações de recurso são armazenadas no Registro por instância de usuário.For each Visual Studio user, resource information is stored in the registry per user instance. Essas informações serão usadas quando um usuário não tiver um projeto aberto e desejar pesquisar dados do Azure Application Insights.This information is used when a user doesn't have a project opened and wants to search Azure Application Insights data. O Visual Studio 2015 usa um local de Registro diferente do Visual Studio 2017 e não entra em conflito com ele.Visual Studio 2015 uses different registry location than Visual Studio 2017 and does not conflict.

Quando um usuário cria um aplicativo Web ASP.NET ou um Aplicativo Web ASP.NET Core, os recursos são armazenados no arquivo .suo.Once a user creates an ASP.NET Web Application or ASP.NET Core Web Application, the resource is stored in the .suo file. O usuário pode abrir o projeto no Visual Studio 2015 ou 2017 e as informações de recurso serão usadas para ambos, desde que o Visual Studio seja compatível com os projetos e as soluções usados nas duas versões.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. Os usuários devem se autenticar uma vez em cada produto.Users need to authenticate once on each product. Por exemplo, se um projeto for criado com o Visual Studio 2015 e aberto no Visual Studio 2017, o usuário precisará se autenticar no 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.
Formulário da Web ou Windows Form em C#/Visual BasicC#/Visual Basic Webform or Windows Form É possível abrir o projeto no Visual Studio 2017 e no Visual Studio 2015.You can open the project in Visual Studio 2017 and Visual Studio 2015.
Projetos de teste de unidade de banco de dados (csproj, .vbproj)Database Unit Test Projects (csproj, .vbproj) Os projetos de teste de unidade de dados mais antigos são carregados no Visual Studio 2017, mas usam a versão do cache de assembly global das dependências.Older Data Unit test projects are loaded in Visual Studio 2017 but use the GAC'd version of dependencies. Para atualizar o projeto de teste de unidade para usar as dependências mais recentes, clique com o botão direito do mouse no projeto no Gerenciador de Soluções e selecione Converter no Projeto de Teste de Unidade do 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# O Visual Studio 2017 pode abrir projetos criados no Visual Studio 2013 e 2015.Visual Studio 2017 can open projects created in Visual Studio 2013 and 2015. No entanto, para habilitar os recursos do Visual Studio 2017 nesses projetos, abra as propriedades do projeto e altere o destino fsharp.core para 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. Observe também que a opção Suporte à linguagem F# no instalador do Visual Studio não é selecionada por padrão com as cargas de trabalho do .NET. Você deve incluí-la selecionando essa opção para a carga de trabalho ou selecionando-a na guia Componentes individuais em Atividades de desenvolvimento.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
Instalação do MSIMSI setup
Projetos do instalador criados no Visual Studio 2010 podem ser abertos em versões posteriores com a ajuda da extensão Projetos do Instalador do 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. Consulte também o WiX Toolset Visual Studio 2017 Extension (Extensão do Conjunto de Ferramentas WiX do Visual Studio 2017).Also see the WiX Toolset Visual Studio 2017 Extension. O InstallShield Limited Edition não está mais incluído com o Visual Studio.InstallShield Limited Edition is no longer included with Visual Studio. Consulte a Flexera Software sobre a disponibilidade para o Visual Studio 2017.Check with Flexera Software about availability for Visual Studio 2017.
LightSwitchLightSwitch Não há mais suporte para o LightSwitch no Visual Studio 2017.LightSwitch is no longer supported in Visual Studio 2017. Os projetos criados com o Visual Studio 2012 e anteriores abertos no Visual Studio 2013 ou no Visual Studio 2015 serão atualizados e poderão ser abertos apenas no Visual Studio 2013 ou no Visual Studio 2015 e posteriores.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.
Ferramentas do Microsoft Azure para Visual StudioMicrosoft Azure Tools for Visual Studio Para abrir esses tipos de projetos, primeiro instale o SDK do Azure para .NET e, em seguida, abra o projeto.To open these types of projects, first install the Azure SDK for .NET, then open the project. Se necessário, o projeto será atualizado.If necessary, your project is updated.
Estrutura Modelo-Exibição-Controlador (ASP.NET MVC)Model-View-Controller framework (ASP.NET MVC) Suporte para versões do MVC e para o Visual Studio:Support for MVC versions and Visual Studio:
  • O Visual Studio 2010 SP1 dá suporte ao MVC 2 e MVC 3; o suporte MVC 4 é adicionado por meio do download do ASP.NET 4 MVC 4 para Visual Studio 2010 SP1Visual 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
  • O Visual Studio 2012 dá suporte apenas ao MVC 3 e ao MVC 4Visual Studio 2012 supports only MVC 3 and MVC 4
  • O Visual Studio 2013 dá suporte apenas ao MVC 4 e ao MVC 5Visual Studio 2013 supports only MVC 4 and MVC 5
  • O Visual Studio 2017 e o Visual Studio 2015 dão suporte ao MVC 4 (é possível abrir projetos existentes, mas não criar novos) e ao MVC 5Visual Studio 2017 and Visual Studio 2015 support MVC 4 (you can open existing projects but not create new ones) and MVC 5

Atualizando versões do MVC:Upgrading MVC versions:
ModelagemModeling Se você permitir que o Visual Studio atualize o projeto automaticamente, será possível abri-lo no Visual Studio 2015, Visual Studio 2013 ou 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.

O formato do projeto de modelagem não foi alterado entre o Visual Studio 2015 e o Visual Studio 2017 e pode ser aberto e modificado em qualquer versão.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. No entanto, há diferenças de comportamento no Visual Studio 2017:However, there are differences in behavior in Visual Studio 2017:
  • Os projetos de modelagem agora são chamados de projetos de “Validação de dependência” nos menus e modelos.Modeling projects are now referred to as "Dependency Validation" projects in the menus and templates.
  • Não há mais suporte para diagramas UML no Visual Studio 2017.UML diagrams are no longer supported in Visual Studio 2017. Os arquivos UML são listados no Gerenciador de Soluções como antes, mas são abertos como arquivos XML.UML files are listed in the Solution Explorer as before but are opened as XML files. Use o Visual Studio 2015 para exibir, criar ou editar diagramas UML.Use Visual Studio 2015 to view, create, or edit UML diagrams.
  • No Visual Studio de 2017, a validação de dependências de arquitetura não é mais executada quando o projeto de modelagem é criado.In Visual Studio 2017, validation of architectural dependencies is no longer performed when the modeling project is built. Em vez disso, a validação é executada durante a criação de cada projeto de código.Instead, validation is carried out as each code project is built. Essa alteração não afeta o projeto de modelagem, mas exige alterações nos projetos de código que estão sendo validados.This change does not affect the modeling project, but it does require changes to the code projects being validated. O Visual Studio 2017 pode fazer as alterações necessárias nos projetos de código automaticamente (mais informações).Visual Studio 2017 can automatically make the necessary changes to the code projects (more information).
Instalação MSI (vdproj)MSI Setup (vdproj) Consulte Projetos do InstallShield.See InstallShield Projects.
Office 2007 VSTOOffice 2007 VSTO Exige uma atualização unidirecional para o Visual Studio 2017.Requires a one-way upgrade for Visual Studio 2017.
Office 2010 VSTOOffice 2010 VSTO Se o projeto for destinado ao .NET Framework 4, será possível abri-lo no Visual Studio 2010 SP1 e posterior.If the project targets the .NET Framework 4, you can open it in Visual Studio 2010 SP1 and later. Todos outros projetos exigem uma atualização unidirecional.All other projects require a one-way upgrade.
Service Fabric (sfproj)Service Fabric (sfproj) Projetos de Aplicativo do Service Fabric podem ser abertos no Visual Studio 2015 ou no Visual Studio 2017, a menos que o projeto de Aplicativo do Service Fabric faça referência a um projeto de serviço do ASP.NET Core.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. Projetos do Service Fabric do Visual Studio 2015 que são abertos no Visual Studio de 2017 são migrados de forma unidirecional do formato xproj para csproj.Service Fabric projects from Visual Studio 2015 that are opened in Visual Studio 2017 are one-way migrated from the xproj format to csproj. Consulte "Projetos do .NET Core (xproj)" anteriormente nesta tabela.See ".NET Core projects (xproj)" earlier in this table.
SharePoint 2010SharePoint 2010 Quando um projeto de solução do SharePoint for aberto com o Visual Studio 2017, ele será atualizado para o SharePoint 2013 ou SharePoint 2016.When a SharePoint solution project is opened with Visual Studio 2017, it's upgraded to either SharePoint 2013 or SharePoint 2016. A carga de trabalho "Desenvolvimento de área de trabalho do .NET" deve ser instalada no Visual Studio 2017 para a atualização.The ".NET Desktop Development" workload must be installed in Visual Studio 2017 for the upgrade.

Para obter mais informações sobre como atualizar projetos do SharePoint, consulte Atualizar para o SharePoint 2013, Atualizar fluxo de trabalho no SharePoint Server 2013 e Criar o farm do SharePoint Server 2016 para uma atualização de anexação de banco de dados.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 Projetos de Suplemento do SharePoint criados no Office Developer Tools Visualização 2 não podem ser abertos no Visual Studio 2017.SharePoint Add-In projects created in Office Developer Tools Preview 2 cannot be opened in Visual Studio 2017. Para contornar essa limitação, atualize o MinimumVisualStudioVersion para a versão 12.0 e o MinimumOfficeToolsVersion para a 12.2 no arquivo csproj vbproj.To work around this limitation, update the MinimumVisualStudioVersion to 12.0 and MinimumOfficeToolsVersion to 12.2 in the csproj vbproj file.
SilverlightSilverlight Não há suporte para projetos do Silverlight no Visual Studio 2017.Silverlight projects not supported in Visual Studio 2017. Para manter os aplicativos do Silverlight, continue a usar o Visual Studio 2015.To maintain Silverlight applications, continue to use Visual Studio 2015.
SQL Server Reporting Services e SQL Server Analysis Services (SSRS, SSDT, SSAS, MSAS)SQL Server Reporting Services and SQL Server Analysis Services (SSRS, SSDT, SSAS, MSAS) O suporte para esses tipos de projeto é fornecido por meio de duas extensões na Galeria do Visual Studio: Projetos de Modelagem do Microsoft Analysis Services e Projetos do 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. Suporte do SSDT também está incluso com a carga de trabalho de Processamento e Armazenamento de Dados no Visual Studio de 2017.SSDT support is also included with the Data Storage and Processing workload in Visual Studio 2017. Para saber mais, confira a página Baixar e instalar o SQL Server Data Tools (SSDT) para Visual Studio.For more information, see the Download and install SQL Server Data Tools (SSDT) for Visual Studio page.
O SQL Server Integration Services (SSIS)SQL Server Integration Services (SSIS) O suporte para o Visual Studio 2017 está disponível por meio do SSDT (SQL Server Data Tools).Support for Visual Studio 2017 is available through the SQL Server Data Tools (SSDT). Para saber mais, confira a página Baixar e instalar o SQL Server Data Tools (SSDT) para Visual Studio e o blog da equipe SQL Server Integration Services (SSIS).For more information, see the Download and install SQL Server Data Tools (SSDT) for Visual Studio page, and the SQL Server Integration Services (SSIS) team blog.
Visual C++Visual C++ Você pode usar o Visual Studio 2017 para trabalhar em projetos criados em versões anteriores do Visual Studio no Visual Studio 2010.You can use Visual Studio 2017 to work in projects that were created in earlier versions of Visual Studio back to Visual Studio 2010. Quando você abre o projeto pela primeira vez, tem a opção de atualizar para o compilador e o conjunto de ferramentas mais recentes, ou continuar usando os originais.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. Se você optar por continuar usando os originais, o Visual Studio 2017 não modificará o arquivo de projeto e usará o conjunto de ferramentas da instalação anterior do Visual Studio para compilar o projeto.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. Manter as opções originais significa que você ainda pode abrir o projeto na versão original do Visual Studio, se for necessário.Keeping the original options means you can still open the project in the original version of Visual Studio if necessary. Para obter mais informações, consulte Usar a multiplataforma nativa no Visual Studio para compilar projetos antigos.For more information, see Use native multi-targeting in Visual Studio to build old projects.
Extensibilidade/VSIX do Visual StudioVisual Studio Extensibility/VSIX Os projetos com o MinimumVersion 14.0 ou inferior serão atualizados para declarar a MinimumVersion 15.0, que impede que o projeto seja aberto em versões anteriores do 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 um projeto seja aberto em versões anteriores, defina MinimumVersion como $(VisualStudioVersion).To allow a project to open in earlier versions, set MinimumVersion to $(VisualStudioVersion). Consulte também Como migrar projetos de extensibilidade para o Visual Studio 2017.See also How to: Migrate Extensibility Projects to Visual Studio 2017.
Visual Studio Lab ManagementVisual Studio Lab Management É possível usar o Microsoft Test Manager ou o Visual Studio 2010 SP1 e posterior para abrir ambientes criados em qualquer uma dessas versões.You can use Microsoft Test Manager or Visual Studio 2010 SP1 and later to open environments created in any of these versions. No entanto, para o Visual Studio 2010 SP1, a versão do Microsoft Test Manager deve corresponder à versão do Team Foundation Server para que você possa criar ambientes.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.
Ferramentas do Visual Studio para Apache CordovaVisual Studio Tools for Apache Cordova Os projetos podem ser abertos no Visual Studio 2017, mas não são compatíveis com versões anteriores.Projects can be opened in Visual Studio 2017, but are not backwards compatible. Ao abrir um projeto do Visual Studio 2015, será solicitado que você permita modificações no projeto.Upon opening a project from Visual Studio 2015, you're prompted to allow modifications to your project. Essa modificação atualiza o projeto para usar conjuntos de ferramentas em vez de um arquivo taco.json para gerenciar o controle de versão da biblioteca Cordova, suas plataformas e seus plug-ins, bem como suas dependências de nó/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, its plugins, and its node/npm dependencies. Consulte o guia de migração para obter mais informações.See the migration guide for more information.
Implantação da Web (wdproj)Web Deployment (wdproj) O suporte para projetos da Implantação da Web foi removido no Visual Studio 2012 com a adição do suporte ao perfil de publicação.Support for Web Deployment projects was removed in Visual Studio 2012 with the addition of publish profile support. Como não há nenhum equivalente no Visual Studio 2017, não há nenhum caminho de migração automática para esses projetos.Because there is no equivalent in Visual Studio 2017, there is no automatic migration path for such projects. Em vez disso, abra o arquivo wdproj em um editor de texto e copie e cole as personalizações em para o arquivo pubxml (perfil de publicação), conforme descrito em 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.
Windows Communication Foundation, Windows Workflow FoundationWindows Communication Foundation, Windows Workflow Foundation É possível abrir esse projeto no Visual Studio 2017, Visual Studio 2015, Visual Studio 2013 e Visual Studio 2012You can open this project in Visual Studio 2017, Visual Studio 2015, Visual Studio 2013, and Visual Studio 2012
Windows Presentation FoundationWindows Presentation Foundation Abra esse projeto no Visual Studio 2017, Visual Studio 2013, Visual Studio 2012 e Visual Studio 2010 SP1.You can open this project in Visual Studio 2017, Visual Studio 2013, Visual Studio 2012, and Visual Studio 2010 SP1.
Aplicativos da Windows Store/aplicativos Windows PhoneWindows Store/Phone apps Não há suporte para projetos da Windows Store 8.1 e 8.0 e do Windows Phone 8.1 e 8.0 no 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 manter esses aplicativos, continue a usar o Visual Studio 2015.To maintain these apps, continue to use Visual Studio 2015. Para manter os projetos do Windows Phone 7. x, use o Visual Studio 2012.To maintain Windows Phone 7.x projects, use Visual Studio 2012.

Como o Visual Studio decide quando migrar um projetoHow Visual Studio decides when to migrate a project

Cada nova versão do Visual Studio geralmente tenta manter a compatibilidade com versões anteriores, de forma que o mesmo projeto pode ser aberto, modificado e compilado em versões diferentes.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. No entanto, há alterações inevitáveis ao longo do tempo, de modo que alguns projetos podem deixar de ter suporte.However, there are inevitable changes over time such that some project types may no longer be supported. (Consulte direcionamento e compatibilidade de plataforma para os quais os tipos de projeto têm suporte no Visual Studio 2017.) Nesses casos, uma versão mais recente do Visual Studio não carregará o projeto e não oferecerá um caminho de migração; Você precisa manter esse projeto em uma versão anterior do Visual Studio que ofereça suporte a ele.(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.

Em outros casos, a versão mais recente do Visual Studio poderá abrir um projeto, mas precisará atualizar ou migrar o projeto, de forma que ele poderá se tornar incompatível com versões anteriores.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. O Visual Studio usa um número de critérios para determinar se essa migração é necessária:Visual Studio uses a number of criteria to determine whether such migration is necessary:

  • Compatibilidade com as versões de destino das plataformas, até o Visual Studio 2013 RTM.Compatibility with the target versions of platforms, back to Visual Studio 2013 RTM.

  • Compatibilidade de ativos de tempo de design com versões anteriores do Visual Studio.Compatibility of design-time assets with previous versions of Visual Studio. (Ou seja, canais diferentes do Visual Studio 2017; Visual Studio 2015 RTM & atualização 3; Visual Studio 2013 RTM & atualização 5; Visual Studio 2012 atualização 4; Visual Studio 2010 SP 1.) O Visual Studio 2017 visa falhar normalmente com ativos de tempo de design preteridos sem corrompê-los, de modo que as versões anteriores ainda possam abrir o projeto.(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.

  • Se novos ativos de tempo de design interromperiam a compatibilidade com versões anteriores até o Visual Studio 2013 RTM e Atualização 5.Whether new design time assets would break compatibility with previous versions down to Visual Studio 2013 RTM & Update 5.

O engenheiro responsável pelo tipo de projeto em questão examina esses critérios e toma a decisão em termos de compatibilidade, suporte e migração.The engineering owner of the project type in question looks at these criteria and makes the call where support, compatibility, and migration are concerned. Novamente, o Visual Studio tenta manter uma compatibilidade transparente entre versões do Visual Studio se possível, o que significa que é possível criar e modificar projetos em uma versão do Visual Studio e ele funcionar em outras versões.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.

Se tal compatibilidade não for possível, no entanto, como ocorre com alguns dos tipos de projeto descritos neste artigo, o Visual Studio abrirá o assistente de atualização para fazer as alterações unidirecionais necessárias.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.

Essas alterações unidirecionais podem envolver a alteração a propriedade ToolsVersion no arquivo de projeto, que indica exatamente qual versão do MSBuild pode transformar o código-fonte do projeto em artefatos executáveis e implantáveis que você deseja.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. Ou seja, o que torna um projeto incompatível com versões anteriores do Visual Studio não é a versão do Visual Studio, mas a versão do MSBuild, conforme determinado por ToolsVersion.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. Desde que sua versão do Visual Studio contenha a cadeia de ferramentas do MSBuild correspondente a ToolsVersion em um projeto, o Visual Studio poderá invocar essa cadeia de ferramentas para compilar o projeto.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.

Para manter a compatibilidade máxima com projetos criados em versões mais antigas, o Visual Studio 2017 inclui as cadeias de ferramentas do MSBuild necessárias para dar suporte a ToolsVersion 14, 15, 12 e 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. Projetos que usam qualquer um desses valores ToolsVersion devem resultar em um build bem-sucedido.Projects that use any of these ToolsVersion values should result in a successful build. (Sujeito, novamente, ao suporte do Visual Studio 2017 ao tipo de projeto, conforme descrito em Direcionamento e compatibilidade de plataformas.)(Subject, again, to whether Visual Studio 2017 supports the project type at all, as described on Platform Targeting and Compatibility.)

Nesse contexto, naturalmente surge o questionamento de se você deve tentar atualizar ou migrar manualmente um projeto para um valor mais recente de ToolsVersion.In this context, the question naturally arises whether you should try to manually update or migrate a project to a newer ToolsVersion value. Essa alteração é desnecessária e provavelmente geraria muitos erros e avisos que você precisaria corrigir para conseguir compilar o projeto novamente.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. Além disso, se o Visual Studio deixar de dar suporte a um determinado ToolsVersion no futuro, abrir o projeto disparará o processo de migração do projeto especificamente porque o valor ToolsVersion precisará ser alterado.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. Nesse caso, o subsistema desse tipo específico de projeto sabe exatamente o que precisa ser alterado e pode fazer essas alterações automaticamente, conforme descrito anteriormente neste artigo.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.

Próximas etapasNext steps

Consulte os seguintes artigos para uma discussão mais detalhada:Refer to the following articles for further discussion:

Confira tambémSee also

Cada nova versão do Visual Studio dá suporte à maioria dos tipos de projetos, arquivos e outros ativos.Each new version of Visual Studio supports most types of projects, files, and other assets. Você pode trabalhar com eles como sempre tem, desde que você não dependa dos recursos mais recentes.You can work with them as you always have, provided that you don't depend on newer features.

Tentamos preservar a compatibilidade com versões anteriores, como o Visual Studio 2017, o Visual Studio 2015, o Visual Studio 2013 e o Visual Studio 2012.We try to preserve backwards compatibility with previous versions, such as Visual Studio 2017, Visual Studio 2015, Visual Studio 2013, and Visual Studio 2012. No entanto, o suporte para alguns tipos de projeto muda ao longo do tempo.However, support for some project types changes over time. Uma versão mais recente do Visual Studio pode não dar suporte a determinados projetos ou pode exigir que você atualize um projeto para que ele não seja mais compatível com versões anteriores.A newer version of Visual Studio might not support certain projects at all, or it might require that you update a project so that it's no longer backwards-compatible.

Observação

Para obter o status atual de problemas de migração, veja a Comunidade do Desenvolvedor do Visual Studio.For current status on migration issues, refer to the Visual Studio Developer Community. E para saber mais sobre quais recursos são específicos para a versão do Visual Studio, consulte as notas de versão.And to learn more about which features are specific to which Visual Studio version, see the Release Notes.

Importante

Alguns tipos de projeto exigem cargas de trabalho específicas.Some project types require specific workloads. Se a carga de trabalho não estiver instalada, o Visual Studio relatará um tipo de projeto desconhecido ou incompatível.If you don't have the workload installed, Visual Studio reports an unknown or incompatible project type. Nesse caso, verifique as Opções de instalação no instalador do Visual Studio e tente novamente.In that case, check your installation options in the Visual Studio Installer and try again. Para obter mais informações sobre o suporte a projetos no Visual Studio 2019, consulte a página direcionamento e compatibilidade de plataforma .For more information about project support in Visual Studio 2019, see the Platform Targeting and Compatibility page.

Tipos de projetoProject types

A lista a seguir descreve o suporte no Visual Studio 2019 para projetos que foram criados em versões anteriores.The following list describes support in Visual Studio 2019 for projects that were created in earlier versions.

Se você não vir um projeto ou tipo de arquivo listado aqui que deveria ser, consulte a versão 2017 do Visual Studio deste artigo.If you don't see a project or file type listed here that should be, consult the Visual Studio 2017 version of this article. Você também pode usar o botão enviar comentários sobre > esta página na parte inferior desta página para fornecer detalhes do seu projeto.You can also use the Send feedback about > This page button at the bottom of this page to provide details of your project. (Se você usar o controle anônimo "Esta página é útil?",(If you use the anonymous "Is this page helpful?" talvez não sejamos capazes de responder aos seus comentários.)control, we aren't able to respond to your feedback.)

Tipo de projetoType of Project SuporteSupport
Projetos do .NET Core (xproj).NET Core projects (xproj) Projetos criados com o Visual Studio 2015 usavam ferramentas de visualização que incluíam um arquivo de projeto xproj.Projects created with Visual Studio 2015 used preview tooling that included an xproj project file.

Visual Studio 2017: não há suporte para o formato xproj além de para migração para o formato csproj.Visual Studio 2017: The xproj format is not supported other than for migration to csproj format. Ao abrir um arquivo xproj, você será solicitado a migrar o arquivo para o formato csproj do estilo SDK.When you open an xproj file, you're prompted to migrate the file to the SDK-style csproj format. (É feito um backup do arquivo xproj.) Não há suporte para projetos csproj de estilo SDK no Visual Studio 2015 e versões anteriores.(A backup of the xproj file is made.) SDK-style csproj projects are not supported in Visual Studio 2015 and earlier.

Visual Studio 2019: na versão 16,3 e posterior, não é possível carregar ou migrar projetos xproj.Visual Studio 2019: In version 16.3 and later, you cannot load or migrate xproj projects. Para obter mais informações, consulte migrando projetos do .NET Core para o formato csproj.For more information, see Migrating .NET Core projects to the csproj format.
Aplicativo Web ASP.NET e Aplicativo Web ASP.NET Core com o Application Insights habilitadoASP.NET Web Application and ASP.NET Core Web Application with Application Insights enabled Para cada usuário do Visual Studio, as informações de recurso são armazenadas no Registro por instância de usuário.For each Visual Studio user, resource information is stored in the registry per user instance. Essas informações serão usadas quando um usuário não tiver um projeto aberto e desejar pesquisar dados do Azure Application Insights.This information is used when a user doesn't have a project opened and wants to search Azure Application Insights data. O Visual Studio 2015 usa uma localização de Registro diferente do Visual Studio 2017 e do Visual Studio 2019 e não entra em conflito com eles.Visual Studio 2015 uses different registry location than Visual Studio 2017 and Visual Studio 2019 and does not conflict.

Quando um usuário cria um aplicativo Web ASP.NET ou um Aplicativo Web ASP.NET Core, os recursos são armazenados no arquivo .suo.Once a user creates an ASP.NET Web Application or ASP.NET Core Web Application, the resource is stored in the .suo file. O usuário pode abrir o projeto no Visual Studio 2015, no Visual Studio 2017 ou no Visual Studio 2019 e as informações de recurso são usadas para cada um, desde que o Visual Studio dê suporte às soluções e aos projetos usados nas duas versões.The user can open the project in Visual Studio 2015, Visual Studio 2017, or Visual Studio 2019, and the resource information is used for each as long as Visual Studio supports projects and solutions being used across both versions. Os usuários devem se autenticar uma vez em cada produto.Users need to authenticate once on each product. Por exemplo, se um projeto for criado com o Visual Studio 2017 e aberto no Visual Studio 2019, o usuário precisará se autenticar no Visual Studio 2019.For example, if a project is created with Visual Studio 2017 and opened in Visual Studio 2019, the user needs to authenticate on Visual Studio 2019.
Formulário da Web ou Windows Form em C#/Visual BasicC#/Visual Basic Webform or Windows Form É possível abrir o projeto no Visual Studio 2019, no Visual Studio 2017 e no Visual Studio 2015.You can open the project in Visual Studio 2019, Visual Studio 2017, and Visual Studio 2015.
Teste de UI codificadoCoded UI Test O teste de IU codificado para teste funcional controlado por interface do usuário automatizado foi preterido no Visual Studio 2019.Coded UI test for automated UI-driven functional testing is deprecated in Visual Studio 2019.

O Visual Studio 2019 será a última versão para o teste de IU codificado.Visual Studio 2019 will be the last release for Coded UI test. Recomendamos usar o Selenium para testar aplicativos Web e o Appium com o WinAppDriver para testar aplicativos UWP e da área de trabalho.We recommend using Selenium for testing web apps and Appium with WinAppDriver for testing desktop and UWP apps.
Projetos de teste de unidade de banco de dados (csproj, .vbproj)Database Unit Test Projects (csproj, .vbproj) Os projetos de teste de unidade de dados mais antigos são carregados no Visual Studio 2019, mas usam a versão do cache de assembly global das dependências.Older Data Unit test projects are loaded in Visual Studio 2019 but use the GAC'd version of dependencies. Para atualizar o projeto de teste de unidade para usar as dependências mais recentes, clique com o botão direito do mouse no projeto no Gerenciador de Soluções e selecione Converter no Projeto de Teste de Unidade do 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# O Visual Studio 2019 pode abrir projetos criados no Visual Studio 2013, no Visual Studio 2015 e no Visual Studio 2017.Visual Studio 2019 can open projects created in Visual Studio 2013, Visual Studio 2015, and Visual Studio 2017. A principal diferença dos modelos mais antigos do Visual Studio para novos projetos é que a versão do FSharp.Core agora sempre é um pacote NuGet.A key difference from older Visual Studio templates for new projects is that the FSharp.Core version is now always a NuGet package. O F# é instalado por padrão com qualquer Carga de Trabalho do .NET.F# is installed by default with any .NET Workload.
InstallShieldInstallShield
Instalação do MSIMSI setup
Projetos do instalador criados no Visual Studio 2010 podem ser abertos em versões posteriores com a ajuda da extensão Projetos do Instalador do 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. Consulte também o WiX Toolset Visual Studio 2017 Extension (Extensão do Conjunto de Ferramentas WiX do Visual Studio 2017).Also see the WiX Toolset Visual Studio 2017 Extension. O InstallShield Limited Edition não está mais incluído com o Visual Studio.InstallShield Limited Edition is no longer included with Visual Studio. Verifique com a Flexera Software sobre a disponibilidade para o Visual Studio 2019.Check with Flexera Software about availability for Visual Studio 2019.
LightSwitchLightSwitch Não há mais suporte para o LightSwitch no Visual Studio 2019 nem no Visual Studio 2017.LightSwitch is no longer supported in Visual Studio 2019 or in Visual Studio 2017. Os projetos criados com o Visual Studio 2012 e anteriores abertos no Visual Studio 2013 ou no Visual Studio 2015 serão atualizados e poderão ser abertos apenas no Visual Studio 2013 ou no Visual Studio 2015 e posteriores.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.
Carregar TesteLoad Test As funcionalidades de teste de carga e desempenho Web foram preteridas no Visual Studio 2019.Web performance and load test capabilities are deprecated in Visual Studio 2019.

O Visual Studio 2019 será a última versão do teste de carga.Visual Studio 2019 will be the last release for load test. Use ferramentas de teste de carga alternativas como Apache JMeter, Akamai CloudTest e Blazemeter.Use alternative load testing tools such as Apache JMeter, Akamai CloudTest, Blazemeter.
Ferramentas do Microsoft Azure para Visual StudioMicrosoft Azure Tools for Visual Studio Para abrir esses tipos de projetos, primeiro instale o SDK do Azure para .NET e, em seguida, abra o projeto.To open these types of projects, first install the Azure SDK for .NET, then open the project. Se necessário, o projeto será atualizado.If necessary, your project is updated.
Microsoft Test ManagerMicrosoft Test Manager O Microsoft Test Manager e o Feedback Client não são mais fornecidos no Visual Studio, a partir do Visual Studio 2019.Microsoft Test Manager and Feedback Client are no longer shipping in Visual Studio, starting with Visual Studio 2019.

Aproveite o Azure Test Plans (parte do Azure DevOps) para suas necessidades de testes manuais e exploratórios.Leverage Azure Test Plans (part of Azure DevOps) for your manual and exploratory testing needs. Para obter mais informações, consulte a página Orientações sobre o uso do Microsoft Test Manager na documentação do Azure DevOps.For more information, see the Guidance on Microsoft Test Manager usage page in the Azure DevOps documentation.
Estrutura Modelo-Exibição-Controlador (ASP.NET MVC)Model-View-Controller framework (ASP.NET MVC) Suporte para versões do MVC e para o Visual Studio:Support for MVC versions and Visual Studio:
  • O Visual Studio 2010 SP1 dá suporte ao MVC 2 e MVC 3; o suporte MVC 4 é adicionado por meio do download do ASP.NET 4 MVC 4 para Visual Studio 2010 SP1Visual 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
  • O Visual Studio 2012 dá suporte apenas ao MVC 3 e ao MVC 4Visual Studio 2012 supports only MVC 3 and MVC 4
  • O Visual Studio 2013 dá suporte apenas ao MVC 4 e ao MVC 5Visual Studio 2013 supports only MVC 4 and MVC 5
  • O Visual Studio 2019, o Visual Studio 2017 e o Visual Studio 2015 dão suporte ao MVC 4 (é possível abrir projetos existentes, mas não criar projetos) e ao MVC 5Visual Studio 2019, Visual Studio 2017, and Visual Studio 2015 support MVC 4 (you can open existing projects but not create new ones) and MVC 5

Atualizando versões do MVC:Upgrading MVC versions:
ModelagemModeling Se você permitir que o Visual Studio atualize o projeto automaticamente, será possível abri-lo no Visual Studio 2015, Visual Studio 2013 ou 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.

O formato do projeto de modelagem não foi alterado desde o Visual Studio 2015 e o projeto pode ser aberto e modificado nessas versões.The format of the modeling project has not changed since Visual Studio 2015 and the project can be opened and modified in these versions. No entanto, há diferenças de comportamento do Visual Studio 2017 e do Visual Studio 2019:However, there are differences in behavior in Visual Studio 2017 and Visual Studio 2019:
  • Os projetos de modelagem agora são chamados de projetos de “Validação de dependência” nos menus e modelos.Modeling projects are now referred to as "Dependency Validation" projects in the menus and templates.
  • Não há mais suporte para diagramas UML no Visual Studio 2017 e no Visual Studio 2019.UML diagrams are no longer supported in Visual Studio 2017 and Visual Studio 2019. Os arquivos UML são listados no Gerenciador de Soluções como antes, mas são abertos como arquivos XML.UML files are listed in the Solution Explorer as before but are opened as XML files. Use o Visual Studio 2015 para exibir, criar ou editar diagramas UML.Use Visual Studio 2015 to view, create, or edit UML diagrams.
  • No Visual Studio 2019, a validação de dependências de arquitetura não é mais executada quando o projeto de modelagem é criado.In Visual Studio 2019, validation of architectural dependencies is no longer performed when the modeling project is built. Em vez disso, a validação é executada durante a criação de cada projeto de código.Instead, validation is carried out as each code project is built. Essa alteração não afeta o projeto de modelagem, mas exige alterações nos projetos de código que estão sendo validados.This change does not affect the modeling project, but it does require changes to the code projects being validated. O Visual Studio 2019 pode fazer as alterações necessárias nos projetos de código automaticamente.Visual Studio 2019 can automatically make the necessary changes to the code projects.
Instalação MSI (vdproj)MSI Setup (vdproj) Consulte Projetos do InstallShield.See InstallShield Projects.
Office 2007 VSTOOffice 2007 VSTO Exige uma atualização unidirecional para o Visual Studio 2019.Requires a one-way upgrade for Visual Studio 2019.
Office 2010 VSTOOffice 2010 VSTO Se o projeto for destinado ao .NET Framework 4, será possível abri-lo no Visual Studio 2010 SP1 e posterior.If the project targets the .NET Framework 4, you can open it in Visual Studio 2010 SP1 and later. Todos outros projetos exigem uma atualização unidirecional.All other projects require a one-way upgrade.
PCL (Biblioteca de Classes Portátil)Portable Class Library (PCL) Os PCLs (Bibliotecas de Classes Portátil) agora não têm suporte.Portable Class Libraries (or PCLs) are now unsupported. O Visual Studio 2019 ainda abrirá os projetos e os compilará, mas não poderá criar projetos PCL.Visual Studio 2019 will still open and build them, but it is not possible to create new PCL projects. Recomendamos migrar o código de um projeto PCL para um projeto .NET Standard.We recommend migrating code in a PCL project to a .NET Standard project.

O suporte ao PCL não será mais incluído por padrão, mas estará disponível na guia "Componentes Individuais" do Visual Studio.PCL support will no longer be included by default, but will be available on the Visual Studio "Individual Components" tab.
Carga de trabalho do PythonPython Workload O suporte para aplicativos do Python Windows IoT Core foi removido no Visual Studio 2019.Support for Python Windows IoT Core apps was removed in Visual Studio 2019. Como não há nenhum equivalente no Visual Studio 2019 Preview, não há nenhum caminho de migração automática para esses projetos.Because there is no equivalent in Visual Studio 2019 Preview, there is no automatic migration path for such projects.

Você pode continuar usando o Visual Studio 2017.You can continue using Visual Studio 2017.
Ferramentas de R para o Visual StudioR Tools for Visual Studio As Ferramentas do R para Visual Studio foram removidas da Carga de Trabalho de Ciência de Dados no Visual Studio 2019.R Tools for Visual Studio was removed from the Data Science Workload in Visual Studio 2019.

Você pode continuar usando o Visual Studio 2017 ou alternativas como o RStudio.You can continue using Visual Studio 2017 or alternatives like RStudio.
Service Fabric (sfproj)Service Fabric (sfproj) Os projetos de Aplicativo do Service Fabric podem ser abertos no Visual Studio 2015, Visual Studio 2017 e Visual Studio 2019 Preview, a menos que o projeto de Aplicativo do Service Fabric referencie um projeto de serviço do ASP.NET Core.Service Fabric Application projects can be opened in either Visual Studio 2015, Visual Studio 2017, and Visual Studio 2019 Preview, unless the Service Fabric Application project references an ASP.NET Core service project. Os projetos do Service Fabric no Visual Studio 2015 que são abertos no Visual Studio 2017 ou no Visual Studio 2019 Preview são migrados de forma unidirecional do formato xproj para csproj.Service Fabric projects from Visual Studio 2015 that are opened in Visual Studio 2017 or in Visual Studio 2019 Preview are one-way migrated from the xproj format to csproj. Consulte "Projetos do .NET Core (xproj)" anteriormente nesta tabela.See ".NET Core projects (xproj)" earlier in this table.
SharePoint 2010SharePoint 2010 Quando um projeto de solução do SharePoint for aberto com o Visual Studio 2019, ele será atualizado para o SharePoint 2013 ou SharePoint 2016.When a SharePoint solution project is opened with Visual Studio 2019, it's upgraded to either SharePoint 2013 or SharePoint 2016. A carga de trabalho "Desenvolvimento para Desktop do .NET" deve ser instalada no Visual Studio 2019 para a atualização.The ".NET Desktop Development" workload must be installed in Visual Studio 2019 for the upgrade.

Para obter mais informações sobre como atualizar projetos do SharePoint, consulte Atualizar para o SharePoint 2013, Atualizar fluxo de trabalho no SharePoint Server 2013 e Criar o farm do SharePoint Server 2016 para uma atualização de anexação de banco de dados.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 Projetos de Suplemento do SharePoint criados no Office Developer Tools Preview 2 não podem ser abertos no Visual Studio 2019.SharePoint Add-In projects created in Office Developer Tools Preview 2 cannot be opened in Visual Studio 2019. Para contornar essa limitação, atualize o MinimumVisualStudioVersion para a versão 12.0 e o MinimumOfficeToolsVersion para a 12.2 no arquivo csproj vbproj.To work around this limitation, update the MinimumVisualStudioVersion to 12.0 and MinimumOfficeToolsVersion to 12.2 in the csproj vbproj file.
SilverlightSilverlight Projetos do Silverlight não são compatíveis no Visual Studio 2019.Silverlight projects not supported in Visual Studio 2019. Para manter os aplicativos do Silverlight, continue a usar o Visual Studio 2015.To maintain Silverlight applications, continue to use Visual Studio 2015.
SQL – RedgateSQL - Redgate O SQL Change Automation Core (anteriormente chamado ReadyRoll Core), o SQL Prompt Core e o SQL Search do Redgate não são mais fornecidos no Instalador do Visual Studio.Redgate's SQL Change Automation Core (previously called ReadyRoll Core), SQL Prompt Core, and SQL Search are no longer shipping in the Visual Studio installer.

Você pode continuar usando o Visual Studio 2017 para essas funcionalidades.You can continue using Visual Studio 2017 for these features. No Visual Studio 2019, você pode fazer a atualização para os produtos pagos SQL Change Automation e SQL Prompt pagos que estão disponíveis no SQL Toolbelt do Redgate.In Visual Studio 2019, you can upgrade to the paid SQL Change Automation and SQL Prompt products that are available in Redgate's SQL Toolbelt.
SQL Server Reporting Services e SQL Server Analysis Services (SSRS, SSDT, SSAS, MSAS)SQL Server Reporting Services and SQL Server Analysis Services (SSRS, SSDT, SSAS, MSAS) O suporte para esses tipos de projeto é fornecido por meio de duas extensões na Galeria do Visual Studio: Projetos de Modelagem do Microsoft Analysis Services e Projetos do 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. Suporte do SSDT também está incluso com a carga de trabalho de Processamento e Armazenamento de Dados no Visual Studio 2019.SSDT support is also included with the Data Storage and Processing workload in Visual Studio 2019. Para saber mais, confira a página Baixar e instalar o SQL Server Data Tools (SSDT) para Visual Studio.For more information, see the Download and install SQL Server Data Tools (SSDT) for Visual Studio page.
O SQL Server Integration Services (SSIS)SQL Server Integration Services (SSIS) O suporte ao Visual Studio 2019 está disponível.Support for Visual Studio 2019 is available. Para saber mais, confira a página Baixar e instalar o SQL Server Data Tools (SSDT) para Visual Studio, o blog da equipe SQL Server Integration Services (SSIS) e a página Projetos do SQL Server Integration Services no Marketplace.For more information, see the Download and install SQL Server Data Tools (SSDT) for Visual Studio page, the SQL Server Integration Services (SSIS) team blog, and the SQL Server Integration Services Projects page on the Marketplace.
Extensão da Janela de TesteTest Window Extension No Visual Studio 2019, algumas APIs de janela de teste que foram marcadas como públicas anteriormente, mas nunca foram documentadas oficialmente, foram removidas.In Visual Studio 2019, some test window APIs that were previously marked public but were never officially documented have been removed. As APIs amplamente visíveis foram marcadas como preteridas no Visual Studio 2017 para fornecer um aviso antecipado aos mantenedores de extensão.Widely visible APIs were marked deprecated in Visual Studio 2017 to give extension maintainers an early warning. Para o nosso conhecimento, poucas extensões haviam criado uma dependência dessas APIs.To our knowledge, few extensions have taken a dependency on these APIs. Para obter mais informações e atualizações, veja a lista completa de APIs relacionadas a teste preteridas.For more info and updates, view the complete list of deprecated test-related APIs. Se isso afetar o seu cenário, informe-nos na comunidade de desenvolvedores.If this affects your scenario, please let us know on developer community.
Visual C++Visual C++ Você pode usar o Visual Studio 2019 para trabalhar em projetos criados em versões anteriores do Visual Studio no Visual Studio 2010.You can use Visual Studio 2019 to work in projects that were created in earlier versions of Visual Studio back to Visual Studio 2010. Quando você abre o projeto pela primeira vez, tem a opção de atualizar para o compilador e o conjunto de ferramentas mais recentes, ou continuar usando os originais.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. Se você optar por continuar usando os originais, o Visual Studio 2019 não modificará o arquivo de projeto e usará o conjunto de ferramentas da instalação anterior do Visual Studio para compilar o projeto.If you choose to keep using the original ones, Visual Studio 2019 does not modify the project file, and uses the toolset from the earlier Visual Studio installation to build your project. Manter as opções originais significa que você ainda pode abrir o projeto na versão original do Visual Studio, se for necessário.Keeping the original options means you can still open the project in the original version of Visual Studio if necessary. Para obter mais informações, consulte Usar a multiplataforma nativa no Visual Studio para compilar projetos antigos.For more information, see Use native multi-targeting in Visual Studio to build old projects.
Extensibilidade/VSIX do Visual StudioVisual Studio Extensibility/VSIX Os projetos com o MinimumVersion 14.0 ou inferior serão atualizados para declarar a MinimumVersion 15.0, que impede que o projeto seja aberto em versões anteriores do 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 um projeto seja aberto em versões anteriores, defina MinimumVersion como $(VisualStudioVersion).To allow a project to open in earlier versions, set MinimumVersion to $(VisualStudioVersion). Consulte também Como migrar projetos de extensibilidade para o Visual Studio 2017.See also How to: Migrate Extensibility Projects to Visual Studio 2017.
Visual Studio Lab ManagementVisual Studio Lab Management É possível usar o Microsoft Test Manager ou o Visual Studio 2010 SP1 e posterior para abrir ambientes criados em qualquer uma dessas versões.You can use Microsoft Test Manager or Visual Studio 2010 SP1 and later to open environments created in any of these versions. No entanto, para o Visual Studio 2010 SP1, a versão do Microsoft Test Manager deve corresponder à versão do Team Foundation Server para que você possa criar ambientes.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.
Ferramentas do Visual Studio para Apache CordovaVisual Studio Tools for Apache Cordova O suporte para o Apache Cordova foi removido no Visual Studio 2019.Support for Apache Cordova was removed in Visual Studio 2019. Como não há nenhum equivalente no Visual Studio 2019, não há nenhum caminho de migração automática para esses projetos.Because there is no equivalent in Visual Studio 2019, there is no automatic migration path for such projects.

Você pode usar a extensão Ferramentas do Cordova para Visual Studio Code (que fornece suporte para a última versão do Cordova) ou continuar usando o Visual Studio 2017.You can use the Cordova Tools for Visual Studio Code extension (which provides support for the latest version of Cordova) or continue using Visual Studio 2017.
Implantação da Web (wdproj)Web Deployment (wdproj) O suporte para projetos da Implantação da Web foi removido no Visual Studio 2012 com a adição do suporte ao perfil de publicação.Support for Web Deployment projects was removed in Visual Studio 2012 with the addition of publish profile support. Como não há nenhum equivalente no Visual Studio 2019, não há nenhum caminho de migração automática para esses projetos.Because there is no equivalent in Visual Studio 2019, there is no automatic migration path for such projects. Em vez disso, abra o arquivo wdproj em um editor de texto e copie e cole as personalizações em para o arquivo pubxml (perfil de publicação), conforme descrito em 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.
Windows Communication Foundation, Windows Workflow FoundationWindows Communication Foundation, Windows Workflow Foundation Abra esse projeto no Visual Studio 2019, Visual Studio 2017, Visual Studio 2015, Visual Studio 2013 e Visual Studio 2012.You can open this project in Visual Studio 2019, Visual Studio 2017, Visual Studio 2015, Visual Studio 2013, and Visual Studio 2012.
Windows Presentation FoundationWindows Presentation Foundation Você pode abrir este projeto no Visual Studio 2019, Visual Studio 2017, Visual Studio 2013, Visual Studio 2012 e Visual Studio 2010 SP1.You can open this project in Visual Studio 2019, Visual Studio 2017, Visual Studio 2013, Visual Studio 2012, and Visual Studio 2010 SP1.
Aplicativos do Windows PhoneWindows Phone apps Não há suporte para projetos do Windows Phone no Visual Studio 2019.Projects for Windows Phone are not supported in Visual Studio 2019.

Para manter os aplicativos do Windows Phone 8.x, use o Visual Studio 2015.To maintain Windows Phone 8.x apps, use Visual Studio 2015. Para manter os projetos do Windows Phone 7. x, use o Visual Studio 2012.To maintain Windows Phone 7.x projects, use Visual Studio 2012.
aplicativos da Windows StoreWindows Store apps Não há suporte para Projetos Universais do Windows de JavaScript no Visual Studio 2019.JavaScript Universal Windows Projects are not supported in Visual Studio 2019. Para manter esses projetos, use o Visual Studio 2017.To maintain these projects, use Visual Studio 2017.

Os SDKs do Windows 10 anteriores ao Windows 10 Fall Creators Update (build 16299) foram removidos do instalador do Visual Studio 2019.Windows 10 SDKs before the Windows 10 Fall Creators Update (build 16299) have been removed from the Visual Studio 2019 installer. Baixe os SDKs mais antigos manualmente ou redirecione seus projetos para que eles usem os SDKs mais recentes.You can download the older SDKs manually or retarget your projects to use the newer SDKs.

Não há suporte para Projetos Universais do Windows usando project.json.Universal Windows Projects using project.json are not supported. Recomendamos atualizar esses projetos para usar referências de pacote.We recommend upgrading these projects to use package references. Como alternativa, adicione uma referência ao Microsoft.NET.Test.Sdk versão 16.0.0.0 no arquivo project.json.Alternately, add a reference to Microsoft.NET.Test.Sdk version 16.0.0.0 in the project.json file.

Não há suporte para projetos da Windows Store 8.1 e 8.0 no Visual Studio 2019.Projects for Windows Store 8.1 and 8.0 are not supported in Visual Studio 2019. Para manter esses aplicativos, continue a usar o Visual Studio 2015.To maintain these apps, continue to use Visual Studio 2015.
XamarinXamarin A extensão Xamarin Live Player para Visual Studio e Visual Studio para Mac foi removida.The Xamarin Live Player extension for Visual Studio and Visual Studio for Mac has been removed. Isso remove qualquer integração e a tela de emparelhamento.This removes the pairing screen and any integration. Em vez disso, use o Visualizador do Xamarin.Forms interno.Instead, use the built in Xamarin.Forms Previewer.

O Emulador do Visual Studio para Android foi removido do Instalador do Visual Studio.The Visual Studio Emulator for Android has been removed from the Visual Studio Installer. Em vez disso, use o novo suporte do Hyper-V no Google Android Emulator.Instead, use the new Hyper-V support in the Google Android emulator.

Migrar um projetoMigrate a project

Enquanto tentamos manter a compatibilidade com as versões anteriores, pode haver alterações que não são compatíveis com as versões anteriores.While we try to maintain compatibility with previous versions, there can be changes that aren't compatible with previous versions. (Consulte direcionamento e compatibilidade de plataforma para os quais os tipos de projeto têm suporte no Visual Studio 2019.) Quando isso acontece, uma versão mais recente do Visual Studio não carregará o projeto nem oferecerá um caminho de migração.(See Platform Targeting and Compatibility for which project types are supported in Visual Studio 2019.) When this happens, a newer version of Visual Studio won't load the project or offer a migration path. Talvez seja necessário manter esse projeto em uma versão anterior do Visual Studio.You might have to maintain that project in a previous version of Visual Studio.

Às vezes, a versão mais recente do Visual Studio pode abrir um projeto, mas ele deve atualizar ou migrar o projeto de uma forma que possa renderizá-lo incompatível com as versões anteriores.Sometimes, the newer version of Visual Studio can open a project, but it must update or migrate the project in a way that might render it incompatible with previous versions. O Visual Studio usa um número de critérios para determinar se essa migração é necessária:Visual Studio uses a number of criteria to determine whether such migration is necessary:

  • Compatibilidade com as versões de destino das plataformas, até o Visual Studio 2013 RTM.Compatibility with the target versions of platforms, back to Visual Studio 2013 RTM.

  • Compatibilidade de ativos de tempo de design com versões anteriores do Visual Studio.Compatibility of design-time assets with previous versions of Visual Studio. (Ou seja, canais diferentes do Visual Studio 2019, Visual Studio 2017; Visual Studio 2015 RTM & atualização 3; Visual Studio 2013 RTM & atualização 5; Visual Studio 2012 atualização 4; Visual Studio 2010 SP 1.) O Visual Studio 2019 visa falhar normalmente com ativos de tempo de design preteridos sem corrompê-los, de modo que as versões anteriores ainda possam abrir o projeto.(Namely different channels of 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 aims to fail gracefully with deprecated design-time assets without corrupting them, such that previous versions can still open the project.

  • Se novos ativos de tempo de design interromperiam a compatibilidade com versões anteriores até o Visual Studio 2013 RTM e Atualização 5.Whether new design time assets would break compatibility with previous versions down to Visual Studio 2013 RTM & Update 5.

A equipe de engenharia que possui o tipo de projeto examina esses critérios e faz a chamada onde o suporte, a compatibilidade e a migração estão preocupados.The engineering team that owns the project type looks at these criteria and makes the call where support, compatibility, and migration are concerned. Novamente, tentamos manter a compatibilidade entre as versões do Visual Studio para que, quando você criar e modificar projetos em uma versão do Visual Studio, ela funcione apenas em outras versões.Again, we try to maintain compatibility between Visual Studio versions so that when you create and modify projects in one version of Visual Studio, it just works in other versions.

Às vezes, a compatibilidade não é possível.Sometimes, compatibility isn't possible. Em seguida, o Visual Studio abre o assistente de atualização para fazer as alterações unidirecionais necessárias.Then, Visual Studio opens the upgrade wizard to make the necessary one-way changes. Essas alterações unidirecionais podem envolver a alteração da ToolsVersion propriedade no arquivo de projeto, que denota exatamente qual versão do MSBuild pode transformar o código-fonte do projeto nos artefatos executáveis e implantáveis que você deseja.These one-way changes might involve changing the ToolsVersion property in the project file, which denotes exactly which version of MSBuild can turn the project's source code into the runnable and deployable artifacts that you want.

O que renderiza um projeto incompatível com as versões anteriores do Visual Studio não é a versão do Visual Studio , mas a versão do MSBuild , conforme determinado pelo ToolsVersion .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. Se sua versão do Visual Studio contiver o ferramentas do MSBuild que corresponde ao ToolsVersion em um projeto, o Visual Studio poderá invocar o ferramentas para compilar o projeto.If 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.

Para manter a compatibilidade com projetos que você criou em versões anteriores, o Visual Studio 2019 inclui o cadeias do MSBuild necessário para dar suporte a ToolsVersion 15, 14, 12 e 4.To maintain compatibility with projects that you created in previous versions, Visual Studio 2019 includes the necessary MSBuild toolchains to support ToolsVersion 15, 14, 12, and 4. Projetos que usam qualquer um desses valores ToolsVersion devem resultar em um build bem-sucedido.Projects that use any of these ToolsVersion values should result in a successful build. (Sujeito, novamente, se o Visual Studio 2019 dá suporte ao tipo de projeto, conforme descrito em compatibilidade e direcionamento de plataforma.)(Subject, again, to whether Visual Studio 2019 supports the project type, as described on Platform Targeting and Compatibility.)

Você pode estar tentado a atualizar manualmente ou migrar um projeto para um ToolsVersion valor mais recente.You might be tempted to manually update or migrate a project to a newer ToolsVersion value. É desnecessário fazer essa alteração e provavelmente geraria muitos erros e avisos que você deve corrigir para que o projeto seja compilado novamente.It's unnecessary to make such a change, and would likely generate many errors and warnings that you must fix to get the project to build again. Além disso, se o Visual Studio não oferecer suporte a um específico ToolsVersion no futuro, o projeto disparará o processo de migração do projeto quando você abri-lo porque seu ToolsVersion valor deve ser alterado.Also, if Visual Studio doesn't support a specific ToolsVersion in the future, then the project triggers the project migration process when you open it because its ToolsVersion value must be changed.

Próximas etapasNext steps

Consulte os seguintes artigos para uma discussão mais detalhada:Refer to the following articles for further discussion:

Confira tambémSee also