Migrar do .NET Framework 1.1

  • Artigo

O Windows 7 e versões posteriores do sistema operacional Windows não dão suporte ao .NET Framework 1.1. Assim, os aplicativos destinados ao .NET Framework 1.1 não serão executados sem modificação no Windows 7 ou em versões posteriores do sistema operacional. Este tópico discute as etapas necessárias para executar um aplicativo que se destina ao .NET Framework 1.1 no Windows 7 e em versões posteriores do sistema operacional Windows. Para saber mais sobre o .NET Framework 1.1 e o Windows 8, confira Executar aplicativos .NET Framework 1.1 no Windows 8 e versões posteriores.

Redirecionar ou recompilar

Há duas maneiras de fazer um aplicativo compilado usando o .NET Framework 1.1 ser executado no Windows 7 ou em versões posteriores do sistema operacional Windows:

  • Redirecione o aplicativo para ser executado com o .NET Framework 4 e versões posteriores. O redirecionamento exige que você adicione um elemento <supportedRuntime> ao arquivo de configuração do aplicativo que permite que ele seja executado no .NET Framework 4 e em versões posteriores. Esse arquivo de configuração utiliza a seguinte forma:

    <configuration>
   <startup>
      <supportedRuntime version="v4.0"/>
   </startup>
</configuration>

  • Recompile o aplicativo com um compilador que tem como alvo o .NET Framework 4 ou uma versão posterior. Se tiver usado originalmente o Visual Studio 2003 para desenvolver e compilar sua solução, você poderá abrir a solução no Visual Studio 2010 (e possivelmente versões posteriores também) e usar a caixa de diálogo Compatibilidade do Projeto para converter a solução e os arquivos do projeto dos formatos usados pelo Visual Studio 2003 para o formato MSBuild (Microsoft Build Engine).

Independentemente de preferir recompilar ou redirecionar seu aplicativo, você deve determinar se o aplicativo é afetado por alguma alterações introduzida em versões posteriores do .NET Framework. Essas alterações são de dois tipos:

  • Alterações interruptivas ocorridas entre o .NET Framework 1.1 e as versões posteriores do .NET Framework.

  • Tipos e membros do tipo que foram marcados como preteridos ou obsoletos entre o .NET Framework 1.1 e versões posteriores do .NET Framework.

Se redirecionar seu aplicativo ou recompilá-lo, você deverá examinar as alterações interruptivas e os tipos e membros obsoletos de cada versão do .NET Framework liberada após o .NET Framework 1.1.

Alterações interruptivas

Quando ocorre uma alteração interruptiva, dependendo da alteração específica, a solução desse problema pode estar disponível tanto para aplicativos redestinados como para recompilados. Em alguns casos, você pode adicionar um elemento filho para o elemento <runtime> do seu arquivo de configuração do aplicativo para restaurar o comportamento anterior. Por exemplo, o arquivo de configuração a seguir restaura a classificação da cadeia de caracteres e o comportamento de comparação usados no .NET Framework 1.1 e pode ser usado com um aplicativo redirecionado ou recompilado.

<configuration>
   <runtime>
      <CompatSortNLSVersion enabled="4096"/>
   </runtime>
</configuration>

No entanto, em alguns casos, você talvez tenha que modificar o código-fonte e recompilar seu aplicativo.

Para avaliar o impacto de alterações interruptivas possíveis em seu aplicativo, você deve examinar a seguinte lista de alterações:

Tipos e membros obsoletos

O impacto de tipos e membros substituídos é um pouco diferente para aplicativos redirecionados e aplicativos recompilados. O uso de tipos e de membros obsoletos não afetará um aplicativo que foi escolhido novamente como destino, a menos que o tipo ou membro obsoleto tenha sido removido fisicamente do assembly. A recompilação de um aplicativo que usa tipos ou associados obsoletos geralmente resulta em um aviso de compilador, em vez de um erro do compilador. No entanto, em alguns casos, ele produz um erro do compilador, e o código que usa o tipo ou membro obsoleto não é compilado com êxito. Neste caso, você deve reescrever o código-fonte que chama o tipo ou membro obsoleto antes de recompilar seu aplicativo. Para saber mais sobre os tipos e membros obsoletos, veja O que está obsoleto na Biblioteca de Classes.

Para avaliar o impacto dos tipos e membros que foram substituídos desde o lançamento do .NET Framework 2.0 SP1, confira O que está obsoleto na biblioteca de classes. Examine as listas de tipos e de membros obsoletos do .NET Framework 2.0 SP1, .NET Framework 3.5 e .NET Framework 4.