Compartilhar via


Como: Usar um arquivo de configuração do aplicativo para o destino um.NET Framework versão

Você pode usar um arquivo de configuração do aplicativo para especificar quais versões do.NET Framework um aplicativo ou componente suporta. Você deve especificar a versão e número de cada suporte de compilação.NET Framework versão quando você usa o <supportedRuntime> Elemento ou <requiredRuntime> Elemento em um arquivo de configuração do aplicativo.

A versão do.NET Framework que um aplicativo é executado é determinado da seguinte maneira:

  • Se a versão do.NET Framework que o aplicativo foi compilado contra está presente no computador, o aplicativo é executado nessa versão.

  • Se a versão do.NET Framework que o aplicativo foi compilado contra não está presente e um arquivo de configuração não especifica uma versão em um <supportedRuntime> Elemento, o aplicativo é executado na versão mais recente do.NET Framework que está presente no computador.

  • Se a versão do.NET Framework que o aplicativo foi compilado contra não está presente e o arquivo de configuração especifica uma versão em um <supportedRuntime> Elemento, o aplicativo é executado na versão mais recente, que é especificado no arquivo de configuração do aplicativo e está presente no computador.

Observação

Um arquivo de configuração do aplicativo deve ter o mesmo nome que o aplicativo, com uma extensão. config acrescentada.Por exemplo, para um aplicativo chamado MyExecutable.exe, o arquivo de configuração do aplicativo deve ser nomeado MyExecutable.exe.config.

Você pode configurar um aplicativo para execução na versão em que ele foi criado ou em uma versão posterior. Por exemplo, um aplicativo criado com o.NET Framework versão 1.0 pode direcionar a versão 1.0, 1.1, 2.0 ou todos os três. Um aplicativo criado com o.NET Framework versão 2.0 pode direcionar somente versão 2.0.

Direcionamento do.NET Framework versão 1.1

A entrada de arquivo de configuração do aplicativo mostrada nesta seção faz com que um aplicativo criado usando o.NET Framework 1.0 para usar o.NET Framework versão 1.1 nos seguintes casos:

  • Se o.NET Framework versão 1.1 está instalado.

  • Se ambas as.NET Framework versão 1.0 e o.NET Framework versão 1.1 são instalados.

Se apenas a versão 1.0 é instalado, o aplicativo será executado porque a versão 1.0 não reconhece o <supportedRuntime> elemento e usará a versão no cabeçalho do arquivo PE que aponta para a versão 1.0.

Na ilustração a seguir, MyApp e o Assembly A tem referências estáticas para o.NET Framework versão 1.0, enquanto o Assembly B tem uma referência estática para o.NET Framework versão 1.1. Neste exemplo, MyApp tem um arquivo de configuração de aplicativo informando que o aplicativo suporta a versão 1.1, portanto, o aplicativo e o Assembly A são redirecionados para usar o.NET Framework versão 1.1.

Arquivo de configuração de aplicativo redirecionamentos de ligação para a versão 1.1 do assembly

Exemplo de MyApp, com o Assembly A e o Assembly B

Para o destino de um aplicativo criado usando o.NET Framework versão 1.0 para executar na.NET Framework versão 1.1

  • Digite o seguinte XML no arquivo de configuração do aplicativo:

    <?xml version ="1.0"?>
    <configuration>
      <startup>
        <supportedRuntime version="v1.1.4322" /> 
      </startup>
    </configuration> 
    

Consulte também

Conceitos

Execução Lado a Lado

Configurando o redirecionamento de ligação de Assembly

Localizar informações de versão de tempo de execução