<supportedRuntime> elemento

Especifica qual versão do Common Language Runtime e, opcionalmente, a versão do .NET Framework à qual o aplicativo dá suporte.

<inicialização de configuração><com suporte deRuntime><>

Sintaxe

<supportedRuntime version="runtime version" sku="SKU ID"/>

Attributes

Observações

Se o <supportedRuntime> elemento não estiver presente no arquivo de configuração do aplicativo, a versão do runtime usada para compilar o aplicativo será usada.

O <supportedRuntime> elemento deve ser usado por todos os aplicativos criados usando a versão 1.1 ou posterior do runtime. Os aplicativos criados para dar suporte somente à versão 1.0 do runtime devem usar o <elemento RequiredRuntime> .

Para aplicativos que dão suporte a versões do runtime do .NET Framework 1.1 a 3.5, quando há suporte para várias versões do runtime, o primeiro elemento deve especificar a versão mais preferencial do runtime e o último elemento deve especificar a versão menos preferencial. Para aplicativos que dão suporte ao .NET Framework 4.0 ou versões posteriores, o version atributo indica a versão CLR, que é comum ao .NET Framework 4 e versões posteriores, e o sku atributo indica a única versão do .NET Framework direcionada ao aplicativo.

Se o <supportedRuntime> elemento com o sku atributo estiver presente no arquivo de configuração e a versão do .NET Framework instalada for inferior à versão com suporte especificada, o aplicativo não será executado e, em vez disso, exibirá uma mensagem solicitando a instalação da versão com suporte. Caso contrário, o aplicativo tentará ser executado em qualquer versão instalada, mas poderá se comportar inesperadamente se não for totalmente compatível com essa versão. (Para obter diferenças de compatibilidade entre versões do .NET Framework, consulte a compatibilidade de aplicativos no .NET Framework.) Portanto, recomendamos que você inclua esse elemento no arquivo de configuração do aplicativo para facilitar o diagnóstico de erro. (O arquivo de configuração gerado automaticamente pelo Visual Studio ao criar um novo projeto já o contém.)

Recomendamos que você teste aplicativos com todas as versões do .NET Framework nas quais eles podem ser executados.

Valores de "versão de runtime"

O runtime atributo especifica a versão CLR (Common Language Runtime) necessária para um determinado aplicativo. Todas as versões do .NET Framework v4.x especificam o v4.0 CLR. A tabela a seguir lista valores válidos para o valor da versão de runtime do version atributo.

Valores de "ID de SKU"

O sku atributo usa um TFM (moniker de estrutura de destino) para indicar a versão do .NET Framework que o aplicativo tem como destino e precisa ser executado. A tabela a seguir lista valores válidos compatíveis com o sku atributo, começando pelo .NET Framework 4.

Example

O exemplo a seguir mostra como especificar a versão de runtime com suporte em um arquivo de configuração. O arquivo de configuração indica que o aplicativo tem como destino o .NET Framework 4.7.

<configuration>
   <startup>
      <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.7" />
   </startup>
</configuration>

Arquivo de configuração

Esse elemento pode ser usado no arquivo de configuração do aplicativo.

Consulte também

• Esquema de configurações de inicialização
• Esquema de arquivos de configuração
• In-Process execução lado a lado