Como: Configurar uma Aplicação para Suportar o .NET Framework 4 ou versões posteriores

Todas as aplicações que alojam o common language runtime (CLR) precisam de iniciar ou ativar o CLR para executar código gerido. Normalmente, uma aplicação .NET Framework corre na versão do CLR em que foi construída, mas pode alterar este comportamento para aplicações de ambiente de trabalho usando um ficheiro de configuração de aplicação (por vezes referido como ficheiro de aplicação.config ). No entanto, não pode alterar o comportamento de ativação padrão para aplicações da Windows Store ou Windows Phone usando um ficheiro de configuração de aplicações. Este artigo explica como permitir que a sua aplicação de ambiente de trabalho funcione noutra versão do .NET Framework e fornece um exemplo de como direcionar versões 4 ou posteriores.

A versão do .NET Framework em que uma aplicação corre é determinada pela seguinte ordem:

• Ficheiro de configuração.

  Se o ficheiro de configuração da aplicação incluir <entradas supportedRuntime> que especificam uma ou mais versões do .NET Framework, e uma dessas versões estiver presente no computador do utilizador, a aplicação corre nessa versão. O ficheiro de configuração lê <entradas suportadasRuntime> na ordem em que estão listadas e utiliza a primeira versão do .NET Framework listada que está presente no computador do utilizador. (Use o <requiredRuntime> elemento para a versão 1.0.)

• Versão compilada.

  Se não houver ficheiro de configuração, mas a versão do .NET Framework em que a aplicação foi construída estiver presente no computador do utilizador, a aplicação corre nessa versão.

• Última versão instalada.

  Se a versão do .NET Framework em que a aplicação foi construída não estiver presente e um ficheiro de configuração não especificar uma versão num <supportedRuntime> elemento, a aplicação tenta correr na versão mais recente do .NET Framework que está presente no computador do utilizador.

  No entanto, as aplicações .NET Framework 1.0, 1.1, 2.0, 3.0 e 3.5 não correm automaticamente no .NET Framework 4 ou versões posteriores e, em alguns casos, o utilizador pode receber um erro e pode ser solicitado a instalar o .NET Framework 3.5. O comportamento de ativação pode também depender do sistema operativo do utilizador, pois diferentes versões do sistema Windows incluem diferentes versões do .NET Framework. Se a sua aplicação suporta tanto o .NET Framework 3.5 como o 4 ou versões posteriores, recomendamos que indique isso com múltiplas entradas no ficheiro de configuração para evitar erros de inicialização do .NET Framework. Para mais informações, consulte Versões e Dependências.

Também pode querer configurar as suas aplicações .NET Framework 3.5 para correrem no .NET Framework 4 ou versões posteriores, mesmo em computadores que tenham o .NET Framework 3.5 instalado, para tirar partido das melhorias de desempenho nas versões 4 e versões posteriores.

Para informações sobre como modificar as suas aplicações .NET Framework 1.0 e 1.1 para suportar Windows 7 e Windows 8, consulte Migração do .NET Framework 1.1.

Executa a tua aplicação no .NET Framework 4.x

1. Adicione ou localize o ficheiro de configuração do projeto .NET Framework.

   O ficheiro de configuração de uma aplicação é um ficheiro XML que está no mesmo diretório e tem o mesmo nome de ficheiro da aplicação, mas com uma .config extensão. Por exemplo, para uma aplicação chamada MyExecutable.exe, o ficheiro de configuração da aplicação é chamado MyExecutable.exe.config.

   Para adicionar um ficheiro de configuração no Visual Studio, encontre a barra de menu e selecione Projetar>Adicionar Novo Item. Escolha Geral no painel esquerdo e depois selecione Ficheiro de Configuração. Nomeie o ficheiro de configuração App.config. Estas opções de menu não estão disponíveis para aplicações da Windows Store porque não pode alterar a política de ativação nessa plataforma.

2. Adicione o <supportedRuntime> ao ficheiro de configuração da aplicação da seguinte forma:

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

   O version atributo especifica a versão CLR que se alinha com a versão do .NET Framework que a sua aplicação suporta. Use as seguintes cordas:

   • .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"

   Pode adicionar vários <elementos suportadosRuntime> , listados por ordem de preferência, para especificar suporte a múltiplas versões do .NET Framework.

A tabela seguinte demonstra como as definições de ficheiros de configuração da aplicação e as versões do .NET Framework instaladas num computador determinam a versão em que uma aplicação .NET Framework 3.5 corre. Os exemplos são específicos para uma aplicação .NET Framework 3.5, mas pode usar lógica semelhante para direcionar aplicações construídas com versões anteriores do .NET Framework. Note que o número de versão do .NET Framework 2.0 (v2.0.50727) é usado para especificar o .NET Framework 3.5 no ficheiro de configuração da aplicação.

* Para mais informações sobre esta mensagem de erro e formas de a evitar, veja .NET Framework Initialization Errors: Managing the User Experience.

Consulte também

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