<Elemento supportedRuntime>

Specifica la versione di Common Language Runtime e, facoltativamente, la versione di .NET Framework supportata dall'applicazione.

<Configurazione>
  <Avvio>
    <supportedRuntime>

Sintassi

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

Attributi

Attributo Descrizione
version Attributo facoltativo.

Valore stringa mediante il quale viene specificata la versione di Common Language Runtime (CLR) supportata da questa applicazione. Per i valori validi dell'attributoversion, vedere la sezione "versione di runtime". Nota: Tramite .NET Framework 3.5, il valore di "versione di runtime" assume la forma principale. minore. build. A partire da .NET Framework 4, sono necessari solo i numeri di versione principale e secondaria, ovvero "v4.0" anziché "v4.0.30319". È consigliabile la stringa più corta.
sku Attributo facoltativo.

Valore stringa che specifica il codice di riferimento del prodotto (SKU), che a sua volta specifica la versione di .NET Framework supportata dall'applicazione.

A partire da .NET Framework 4.0, è consigliabile usare l'attributo sku . Quando è presente, indica la versione di .NET Framework di destinazione dell'app.

Per i valori validi dell'attributosku, vedere la sezione "ID SKU".

Commenti

Se l'elemento <supportedRuntime> non è presente nel file di configurazione dell'applicazione, viene usata la versione del runtime usata per compilare l'applicazione.

L'elemento <supportedRuntime> deve essere usato da tutte le applicazioni compilate usando la versione 1.1 o successiva del runtime. Le applicazioni compilate per supportare solo la versione 1.0 del runtime devono usare l'elemento <requiredRuntime> .

Nota

Se si usa la funzione CorBindToRuntimeByCfg per specificare il file di configurazione, è necessario usare l'elemento <requiredRuntime> per tutte le versioni del runtime. L'elemento <supportedRuntime> viene ignorato quando si usa CorBindToRuntimeByCfg.

Per le app che supportano le versioni di runtime da .NET Framework 1.1 a 3.5, quando sono supportate più versioni, il primo elemento deve indicare la versione preferita, mentre l'ultimo elemento quella meno desiderata. Per le app che supportano .NET Framework 4.0 o versioni successive, l'attributo version indica la versione CLR, comune a .NET Framework 4 e versioni successive e l'attributo sku indica la singola versione di .NET Framework di destinazione dell'app.

Se l'elemento <supportedRuntime> con l'attributo sku è presente nel file di configurazione e la versione di .NET Framework installata è inferiore alla versione supportata specificata, l'applicazione non viene eseguita e viene visualizzato un messaggio che chiede di installare la versione supportata. In caso contrario, l'applicazione tenta di essere eseguita in qualsiasi versione installata, ma può comportarsi in modo imprevisto se non è completamente compatibile con tale versione. Per le differenze di compatibilità tra le versioni di .NET Framework, vedere Compatibilità delle applicazioni in .NET Framework. Pertanto, è consigliabile includere questo elemento nel file di configurazione dell'applicazione per semplificare la diagnostica degli errori. Il file di configurazione generato automaticamente da Visual Studio durante la creazione di un nuovo progetto lo contiene già.

Nota

Se l'applicazione usa percorsi di attivazione legacy, ad esempio la funzione CorBindToRuntimeEx e si vuole che tali percorsi attivino la versione 4 di CLR anziché una versione precedente oppure se l'applicazione viene compilata con .NET Framework 4 ma ha una dipendenza da un assembly in modalità mista compilato con una versione precedente di .NET Framework, non è sufficiente specificare .NET Framework 4 nell'elenco dei runtime supportati. Inoltre, nell'elemento di <avvio> nel file di configurazione, è necessario impostare l'attributo useLegacyV2RuntimeActivationPolicy su true. Tuttavia, l'impostazione di questo attributo su true significa che tutti i componenti compilati con le versioni precedenti di .NET Framework vengono eseguiti usando .NET Framework 4 anziché i runtime con cui sono stati compilati.

È inoltre consigliabile testare l'applicazione con tutte le versioni di .NET Framework in cui possono essere eseguite.

Valori di "runtime version"

L'attributo runtime specifica la versione CLR (Common Language Runtime) necessaria per una determinata applicazione. Tutte le versioni di .NET Framework v4.x specificano v4.0 CLR. Nella tabella seguente sono elencati i valori validi per il valore della versione di runtime dell'attributo version .

Versione di .NET Framework Attributo 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"

Valori "ID SKU"

L'attributo sku usa un moniker del framework di destinazione (TFM) per indicare la versione di .NET Framework a cui l'app è destinata e richiede l'esecuzione. Nella tabella seguente sono elencati i valori validi supportati dall'attributo sku , a partire da .NET Framework 4.

Versione di .NET Framework Attributo sku
4,0 ".NETFramework,Version=v4.0"
4.0, Client Profile ".NETFramework,Version=v4.0,Profile=Client"
4.0, aggiornamento piattaforma 1 ". NETFramework,Version=v4.0.1"
4.0, Client Profile, aggiornamento 1 ". NETFramework,Version=v4.0.1,Profile=Client"
4.0, aggiornamento piattaforma 2 ". NETFramework,Version=v4.0.2"
4.0, Client Profile, aggiornamento 2 ". NETFramework,Version=v4.0.2,Profile=Client"
4.0, aggiornamento piattaforma 3 ". NETFramework,Version=v4.0.3"
4.0, Client Profile, aggiornamento 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"

Esempio

L'esempio seguente illustra come specificare la versione di runtime in un file di configurazione. Il file di configurazione indica che l'app è destinata a .NET Framework 4.7.

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

File di configurazione

L'elemento può essere utilizzato nel file di configurazione dell'applicazione.

Vedi anche