elemento <supportedRuntime>

Especifica qual a versão de runtime da common language e, opcionalmente, a versão do .NET Framework que a aplicação suporta.

< > <configuração de arranque><suportadaRuntime>

Sintaxe

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

Attributes

Observações

Se o <supportedRuntime> elemento não estiver presente no ficheiro de configuração da aplicação, é utilizada a versão do tempo de execução usada para construir a aplicação.

O <supportedRuntime> elemento deve ser utilizado por todas as aplicações construídas com a versão 1.1 ou posterior do runtime. Aplicações construídas para suportar apenas a versão 1.0 do runtime devem usar o <elemento requiredRuntime> .

Para aplicações que suportam versões do runtime do .NET Framework 1.1 até 3.5, quando são suportadas múltiplas versões do runtime, o primeiro elemento deve especificar a versão mais preferida do runtime, e o último elemento deve especificar a versão menos preferida. Para aplicações que suportam o .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 que a aplicação visa.

Se o <supportedRuntime> elemento com o sku atributo estiver presente no ficheiro de configuração e a versão instalada do .NET Framework for inferior à versão suportada especificada, a aplicação falha em correr e, em vez disso, apresenta uma mensagem a pedir para instalar a versão suportada. Caso contrário, a aplicação tenta correr em qualquer versão instalada, mas pode comportar-se de forma inesperada se não for totalmente compatível com essa versão. (Para diferenças de compatibilidade entre versões do .NET Framework, veja Compatibilidade de aplicações no .NET Framework.) Por isso, recomendamos que inclua este elemento no ficheiro de configuração da aplicação para facilitar o diagnóstico de erros. (O ficheiro de configuração gerado automaticamente pelo Visual Studio ao criar um novo projeto já o contém.)

Recomendamos que teste aplicações com todas as versões do .NET Framework em que possam correr.

Valores de "versão em tempo de execução"

O runtime atributo especifica a versão Common Language Runtime (CLR) que é exigida para uma dada aplicação. Todas as versões do .NET Framework v4.x especificam o v4.0 CLR. A tabela seguinte lista valores válidos para o valor da versão em tempo de execução do version atributo.

Valores de "ID SKU"

O sku atributo utiliza um nome de framework de destino (TFM) para indicar a versão do .NET Framework que a aplicação tem como alvo e precisa de ser executada. A tabela seguinte lista os valores válidos suportados pelo sku atributo, começando pelo .NET Framework 4.

Example

O exemplo seguinte mostra como especificar a versão de runtime suportada num ficheiro de configuração. O ficheiro de configuração indica que a aplicação tem como alvo o .NET Framework 4.7.

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

Arquivo de configuração

Este elemento pode ser usado no ficheiro de configuração da aplicação.

Consulte também

• Esquema de Definições de Arranque
• esquema do arquivo de configuração
• In-Process Execução Lado a Lado