Como: Configurar um aplicativo para oferecer suporte ao .NET Framework 4 ou versões posteriores

Todos os aplicativos que hospedam o Common Language Runtime (CLR) precisam iniciar ou ativar o CLR para executar o código gerenciado. Normalmente, um aplicativo .NET Framework é executado na versão do CLR em que foi criado, mas você pode alterar esse comportamento para aplicativos da área de trabalho usando um arquivo de configuração do aplicativo (às vezes chamado de arquivo app.config). No entanto, não é possível alterar o comportamento de ativação padrão para aplicativos da Windows Store ou aplicativos do Windows Phone usando um arquivo de configuração de aplicativo. Este artigo explica como habilitar seu aplicativo da área de trabalho para ser executado em outra versão do .NET Framework e fornece um exemplo de como direcionar a versão 4 ou versões posteriores.

A versão do .NET Framework em que um aplicativo é executado é determinada na seguinte ordem:

• Arquivo de configuração.

  Se o arquivo de configuração do aplicativo incluir <entradas supportedRuntime> que especificam uma ou mais versões do .NET Framework e uma dessas versões estiver presente no computador do usuário, o aplicativo será executado nessa versão. O arquivo de configuração lê as <entradas supportedRuntime> na ordem em que são listadas e usa a primeira versão do .NET Framework listada que está presente no computador do usuário. (Utilize a seringa <elemento requiredRuntime> para a versão 1.0.)

• Versão compilada.

  Se não houver nenhum arquivo de configuração, mas a versão do .NET Framework na qual o aplicativo foi criado estiver presente no computador do usuário, o aplicativo será executado nessa versão.

• Última versão instalada.

  Se a versão do .NET Framework em que o aplicativo foi criado não estiver presente e um arquivo de configuração não especificar uma versão em um <elemento supportedRuntime>, o aplicativo tentará ser executado na versão mais recente do .NET Framework que está presente no computador do usuário.

  No entanto, os aplicativos .NET Framework 1.0, 1.1, 2.0, 3.0 e 3.5 não são executados automaticamente no .NET Framework 4 ou posterior e, em alguns casos, o usuário pode receber um erro e pode ser solicitado a instalar o .NET Framework 3.5. O comportamento de ativação também pode depender do sistema operacional do usuário, porque diferentes versões do sistema Windows incluem versões diferentes do .NET Framework. Se seu aplicativo oferecer suporte ao .NET Framework 3.5 e 4 ou posterior, recomendamos que você indique isso com várias entradas no arquivo de configuração para evitar erros de inicialização do .NET Framework. Para obter mais informações, consulte Versões e dependências.

Você também pode querer configurar seus aplicativos do .NET Framework 3.5 para serem executados no .NET Framework 4 ou versões posteriores, mesmo em computadores que tenham o .NET Framework 3.5 instalado, para aproveitar as melhorias de desempenho nas versões 4 e versões posteriores.

Para obter informações sobre como modificar seus aplicativos do .NET Framework 1.0 e 1.1 para oferecer suporte ao Windows 7 e Windows 8, consulte Migrando do .NET Framework 1.1.

Para configurar seu aplicativo para ser executado no .NET Framework 4 ou versões posteriores

1. Adicione ou localize o arquivo de configuração para o projeto .NET Framework. O arquivo de configuração de um aplicativo está no mesmo diretório e tem o mesmo nome do aplicativo, mas tem uma extensão .config. Por exemplo, para um aplicativo chamado MyExecutable.exe, o arquivo de configuração do aplicativo é chamado MyExecutable.exe.config.

   Para adicionar um arquivo de configuração, na barra de menus do Visual Studio, escolha Projeto, Adicionar Novo Item. Escolha Geral no painel esquerdo e, em seguida, escolha Arquivo de configuração. Nomeie o arquivo de configuração App.config. Essas opções de menu não estão disponíveis para projetos de aplicativos da Windows Store ou do Windows Phone, porque você não pode alterar a política de ativação nessas plataformas.

2. Adicione o <elemento supportedRuntime> da seguinte forma ao arquivo de configuração do aplicativo:

   <configuration>
     <startup>
       <supportedRuntime version="version"/>
     </startup>
   </configuration>
   

   onde <version> especifica a versão do CLR que se alinha com a versão do .NET Framework suportada pelo seu aplicativo. Use as seguintes cadeias de caracteres:

   • .NET Framework 1.0: "v1.0.3705"

   • .NET Framework 1.1: "v1.1.4322"

   • .NET Framework 2.0, 3.0 e 3.5: "v2.0.50727"

   • .NET Framework 4 e versões posteriores: "v4.0"

   Você pode adicionar vários <elementos supportedRuntime> , listados em ordem de preferência, para especificar o suporte para várias versões do .NET Framework.

A tabela a seguir demonstra como as definições do arquivo de configuração do aplicativo e as versões do .NET Framework instaladas em um computador determinam a versão em que um aplicativo do .NET Framework 3.5 é executado. Os exemplos são específicos para um aplicativo .NET Framework 3.5, mas você pode usar lógica semelhante para direcionar aplicativos criados com versões anteriores do .NET Framework. Observe que o número de versão do .NET Framework 2.0 (v2.0.50727) é usado para especificar o .NET Framework 3.5 no arquivo de configuração do aplicativo.

* Para obter mais informações sobre essa mensagem de erro e maneiras de evitá-la, consulte Erros de inicialização do .NET Framework: gerenciando a experiência do usuário.

Consulte também

• Migrando do .NET Framework 1.1
• Guia de Migração