<supportedRuntime element (elemento supportedRuntime> )

Artigo
05/10/2023

Especifica a versão do runtime de linguagem comum e, opcionalmente, .NET Framework versão suportada pela aplicação.

<configuração>
<arranque>
<supportedRuntime>

Syntax

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

Atributos

Atributo Descrição

versão Atributo opcional.

Um valor de cadeia que especifica a versão do runtime de linguagem comum (CLR) que esta aplicação suporta. Para obter valores válidos do version atributo, veja a secção de valores "versão do runtime ". Nota: Através do .NET Framework 3.5, o valor "versão do runtime" assume o formulário principal. menor. compilação. A partir do .NET Framework 4, são necessários apenas os números de versão principal e secundária (ou seja, "v4.0" em vez de "v4.0.30319"). Recomenda-se a cadeia mais curta.

sku Atributo opcional.

Um valor de cadeia que especifica a unidade de manutenção de stock (SKU), que, por sua vez, especifica qual .NET Framework versão suportada por esta aplicação.

A partir do .NET Framework 4.0, recomenda-se a sku utilização do atributo. Quando estiver presente, indica a versão do .NET Framework que a aplicação é direcionada.

Para obter valores válidos do sku atributo, veja a secção "SKU ID values" (Valores de "ID do SKU ").

Atributo	Descrição
versão	Atributo opcional. Um valor de cadeia que especifica a versão do runtime de linguagem comum (CLR) que esta aplicação suporta. Para obter valores válidos do `version` atributo, veja a secção de valores "versão do runtime ". Nota: Através do .NET Framework 3.5, o valor "versão do runtime" assume o formulário principal. menor. compilação. A partir do .NET Framework 4, são necessários apenas os números de versão principal e secundária (ou seja, "v4.0" em vez de "v4.0.30319"). Recomenda-se a cadeia mais curta.
sku	Atributo opcional. Um valor de cadeia que especifica a unidade de manutenção de stock (SKU), que, por sua vez, especifica qual .NET Framework versão suportada por esta aplicação. A partir do .NET Framework 4.0, recomenda-se a `sku` utilização do atributo. Quando estiver presente, indica a versão do .NET Framework que a aplicação é direcionada. Para obter valores válidos do `sku` atributo, veja a secção "SKU ID values" (Valores de "ID do SKU ").

Observações

Se o <elemento supportedRuntime> não estiver presente no ficheiro de configuração da aplicação, é utilizada a versão do runtime utilizado para criar a aplicação.

O <elemento supportedRuntime> deve ser utilizado por todas as aplicações criadas com a versão 1.1 ou posterior do runtime. As aplicações criadas para suportar apenas a versão 1.0 do runtime têm de utilizar o <elemento requiredRuntime> .

Nota

Se utilizar a função CorBindToRuntimeByCfg para especificar o ficheiro de configuração, tem de utilizar o <requiredRuntime> elemento para todas as versões do runtime. O <supportedRuntime> elemento é ignorado quando utiliza CorBindToRuntimeByCfg.

Para aplicações que suportam versões do runtime do .NET Framework 1.1 a 3.5, quando são suportadas 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 aplicações que suportam o .NET Framework 4.0 ou versões posteriores, o version atributo indica a versão CLR, que é comum às versões .NET Framework 4 e posteriores, e o sku atributo indica a versão de .NET Framework única que a aplicação procura.

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

Nota

Se a sua aplicação utilizar caminhos de ativação legados, como a função CorBindToRuntimeEx, e quiser que esses caminhos ativem a versão 4 do CLR em vez de uma versão anterior, ou se a sua aplicação for criada com o .NET Framework 4, mas tiver uma dependência numa assemblagem de modo misto criada com uma versão anterior do .NET Framework, não é suficiente especificar a .NET Framework 4 na lista de runtimes suportados. Além disso, no <elemento de arranque> no ficheiro de configuração, tem de definir o useLegacyV2RuntimeActivationPolicy atributo como true. No entanto, definir este atributo como true significa que todos os componentes criados com versões anteriores do .NET Framework são executados com o .NET Framework 4 em vez dos runtimes com que foram criados.

Recomendamos que teste aplicações com todas as versões .NET Framework em que podem ser executadas.

Valores de "versão do runtime"

O runtime atributo especifica a versão do Common Language Runtime (CLR) necessária para uma determinada aplicação. Todas as .NET Framework versões v4.x especificam o v4.0 CLR. A tabela seguinte lista valores válidos para o valor da versão do runtime do version atributo .

Versão do .NET Framework	Atributo `version`
1.0	"v1.0.3705"
1.1	"v1.1.4322"
2.0	"v2.0.50727"
3.0	"v2.0.50727"
3.5	"v2.0.50727"
4.0-4.8.1	"v4.0"

Valores de "ID de SKU"

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

Versão do .NET Framework	Atributo `sku`
4.0	". NETFramework,Version=v4.0"
4.0, Perfil de Cliente	". NETFramework,Version=v4.0,Profile=Client"
4.0, atualização da plataforma 1	". NETFramework,Version=v4.0.1"
4.0, Perfil de Cliente, atualização 1	". NETFramework,Version=v4.0.1,Profile=Client"
4.0, atualização da plataforma 2	". NETFramework,Version=v4.0.2"
4.0, Perfil de Cliente, atualização 2	". NETFramework,Version=v4.0.2,Profile=Client"
4.0, atualização da plataforma 3	". NETFramework,Version=v4.0.3"
4.0, Perfil de Cliente, atualização 3	". NETFramework,Version=v4.0.3,Profile=Client"
4,5	". NETFramework,Version=v4.5"
4.5.1	". NETFramework,Version=v4.5.1"
4.5.2	". NETFramework,Version=v4.5.2"
4,6	". NETFramework,Version=v4.6"
4.6.1	". NETFramework,Version=v4.6.1"
4.6.2	". NETFramework,Version=v4.6.2"
4.7	". NETFramework,Version=v4.7"
4.7.1	". NETFramework,Version=v4.7.1"
4.7.2	". NETFramework,Version=v4.7.2"
4.8	". NETFramework,Version=v4.8"
4.8.1	". NETFramework,Version=v4.8.1"

Exemplo

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 destino .NET Framework 4.7.

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

Ficheiro de configuração

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

Partilhar via