<supportedRuntime> elemento<supportedRuntime> Element

Specifica le versioni di Common Language Runtime supportate dall'applicazione.Specifies which versions of the common language runtime the application supports. È necessario utilizzare questo elemento in tutte le applicazioni compilate con la versione 1.1 o successiva di .NET Framework.This element should be used by all applications built with version 1.1 or later of the .NET Framework.

<configuration><configuration>
  <startup>  <startup>
    <supportedRuntime>    <supportedRuntime>

SintassiSyntax

<supportedRuntime version="runtime version" sku="sku id"/>  

AttributiAttributes

AttributoAttribute DescrizioneDescription
versionversion Attributo facoltativo.Optional attribute.

Valore stringa mediante il quale viene specificata la versione di Common Language Runtime (CLR) supportata da questa applicazione.A string value that specifies the version of the common language runtime (CLR) that this application supports. Per i valori validi del version attributo, vedere il valori "runtime version" sezione.For valid values of the version attribute, see the "runtime version" values section. Nota: tramite .NET Framework 3.5, il "versione runtime" valore assume la forma principali. minori. Compilare.Note: Through the .NET Framework 3.5, the "runtime version" value takes the form major.minor.build. A partire da .NET Framework 4.NET Framework 4, sono necessari solo i numeri delle versioni principale e secondaria (vale a dire, "v4.0" anziché "v4.0.30319").Beginning with the .NET Framework 4.NET Framework 4, only the major and minor version numbers are required (that is, "v4.0" instead of "v4.0.30319"). È consigliabile la stringa più corta.The shorter string is recommended.
skusku Attributo facoltativo.Optional attribute.

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 string value that specifies the stock-keeping unit (SKU), which in turn specifies which .NET Framework release this application supports.

A partire da .NET Framework 4.0, l'utilizzo del sku consiglia di attributo.Starting with the .NET Framework 4.0, the use of the sku attribute is recommended. Quando è presente, indica la versione di .NET Framework di destinazione dell'app.When present, it indicates the version of the .NET Framework that the app targets.

Per i valori validi dell'attributo sku, vedere il i valori di "sku id" sezione.For valid values of the sku attribute, see the "sku id" values section.

NoteRemarks

Se il <supportedRuntime > elemento non è presente nel file di configurazione dell'applicazione, viene utilizzata la versione di CLR impiegata per compilare l'applicazione.If the <supportedRuntime> element is not present in the application configuration file, the version of the runtime used to build the application is used.

Il <supportedRuntime > elemento deve essere utilizzato da tutte le applicazioni compilate con la versione 1.1 o successiva del runtime.The <supportedRuntime> element should be used by all applications built using version 1.1 or later of the runtime. Nelle applicazioni compilate per supportare esclusivamente la versione 1.0 del runtime è necessario utilizzare il <requiredRuntime > elemento.Applications built to support only version 1.0 of the runtime must use the <requiredRuntime> element.

Nota

Se si utilizza il CorBindToRuntimeByCfg funzione per specificare il file di configurazione, è necessario utilizzare il <requiredRuntime> elemento per tutte le versioni del runtime.If you use the CorBindToRuntimeByCfg function to specify the configuration file, you must use the <requiredRuntime> element for all versions of the runtime. Il <supportedRuntime> elemento viene ignorato quando si utilizza CorBindToRuntimeByCfg.The <supportedRuntime> element is ignored when you use 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.For apps that support versions of the runtime from the .NET Framework 1.1 through 3.5, when multiple versions of the runtime are supported, the first element should specify the most preferred version of the runtime, and the last element should specify the least preferred version. Per le applicazioni che supportano il .NET Framework 4.0 o versioni successive, il version attributo indica la versione CLR che è comune a di .NET Framework 4 e versioni successive, e sku attributo indica una singola versione di .NET Framework che l'app destinazioni.For apps that support the .NET Framework 4.0 or later versions, the version attribute indicates the CLR version, which is common to the .NET Framework 4 and later versions, and the sku attribute indicates single .NET Framework version that the app targets.

Nota

Se l'applicazione usa i percorsi di attivazione legacy, ad esempio il funzione CorBindToRuntimeEx, e si desidera attivare la versione 4 di CLR anziché una versione precedente, tali percorsi oppure se l'applicazione viene compilata con la .NET Framework 4.NET Framework 4ma presenta una dipendenza su un assembly in modalità mista compilato con una versione precedente di .NET Framework, non è sufficiente specificare il .NET Framework 4.NET Framework 4 nell'elenco dei runtime supportati.If your application uses legacy activation paths, such as the CorBindToRuntimeEx function, and you want those paths to activate version 4 of the CLR instead of an earlier version, or if your application is built with the .NET Framework 4.NET Framework 4 but has a dependency on a mixed-mode assembly built with an earlier version of the .NET Framework, it is not sufficient to specify the .NET Framework 4.NET Framework 4 in the list of supported runtimes. Inoltre, nel <avvio > elemento nel file di configurazione, è necessario impostare il useLegacyV2RuntimeActivationPolicy attributo true.In addition, in the <startup> element in your configuration file, you must set the useLegacyV2RuntimeActivationPolicy attribute to true. Tuttavia, se questo attributo viene impostato su true tutti i componenti compilati con le versioni precedenti di .NET Framework vengono eseguiti utilizzando .NET Framework 4.NET Framework 4 invece dei runtime con cui sono stati compilati.However, setting this attribute to true means that all components built with earlier versions of the .NET Framework are run using the .NET Framework 4.NET Framework 4 instead of the runtimes they were built with.

È inoltre consigliabile testare l'applicazione con tutte le versioni di .NET Framework in cui possono essere eseguite.We recommend that you test applications with all the .NET Framework versions that they can run on.

Valori di "runtime version""runtime version" values

Il runtime attributo specifica la versione di Common Language Runtime (CLR) che è necessaria per una determinata applicazione.The runtime attribute specifies the Common Language Runtime (CLR) version that is required for a given application. Si noti che tutte le versioni di .NET Framework 4. x specificare il v4.0 CLR.Note that all .NET Framework v4.x versions specify the v4.0 CLR. Nella tabella seguente sono elencati i valori validi per il versione runtime valore il version attributo.The following table lists valid values for the runtime version value of the version attribute.

Versione di .NET Framework.NET Framework version Attributo versionversion attribute
1.01.0 "v1.0.3705""v1.0.3705"
1.11.1 "v1.1.4322""v1.1.4322"
2.02.0 "v2.0.50727""v2.0.50727"
3.03.0 "v2.0.50727""v2.0.50727"
3.53.5 "v2.0.50727""v2.0.50727"
4.7.2 4.04.0-4.7.2 "v4.0""v4.0"

Valori di "sku id""sku id" values

Il sku attributo Usa un moniker del framework di destinazione (TFM) per indicare la versione di .NET Framework che l'app ha come destinazione e deve essere eseguito.The sku attribute uses a target framework moniker (TFM) to indicate the version of the .NET Framework that the app targets and requires to run. Nella tabella seguente sono elencati i valori validi che sono supportati dal sku attributo, a partire da .NET Framework 4.The following table lists valid values that are supported by the sku attribute, starting with the .NET Framework 4.

Versione di .NET Framework.NET Framework version Attributo skusku attribute
4.04.0 ".NETFramework,Version=v4.0"".NETFramework,Version=v4.0"
4.0, Client Profile4.0, Client Profile ".NETFramework,Version=v4.0,Profile=Client"".NETFramework,Version=v4.0,Profile=Client"
4.0, aggiornamento piattaforma 14.0, platform update 1 .NETFramework,Version=v4.0.1.NETFramework,Version=v4.0.1
4.0, Client Profile, aggiornamento 14.0, Client Profile, update 1 .NETFramework, Version=v4.0.1, Profile=Client.NETFramework,Version=v4.0.1,Profile=Client
4.0, aggiornamento piattaforma 24.0, platform update 2 .NETFramework,Version=v4.0.2.NETFramework,Version=v4.0.2
4.0, Client Profile, aggiornamento 24.0, Client Profile, update 2 .NETFramework, Version=v4.0.2, Profile=Client.NETFramework,Version=v4.0.2,Profile=Client
4.0, aggiornamento piattaforma 34.0, platform update 3 .NETFramework,Version=v4.0.3.NETFramework,Version=v4.0.3
4.0, Client Profile, aggiornamento 34.0, Client Profile, update 3 .NETFramework,Version=v4.0.3,Profile=Client.NETFramework,Version=v4.0.3,Profile=Client
4.54.5 ".NETFramework,Version=v4.5"".NETFramework,Version=v4.5"
4.5.14.5.1 ".NETFramework,Version=v4.5.1"".NETFramework,Version=v4.5.1"
4.5.24.5.2 ".NETFramework,Version=v4.5.2"".NETFramework,Version=v4.5.2"
4.64.6 ".NETFramework,Version=v4.6"".NETFramework,Version=v4.6"
4.6.14.6.1 ".NETFramework,Version=v4.6.1"".NETFramework,Version=v4.6.1"
4.6.24.6.2 ".NETFramework,Version=v4.6.2"".NETFramework,Version=v4.6.2"
4.74.7 ". NETFramework, Version = v 4.7 "".NETFramework,Version=v4.7"
4.7.14.7.1 ". NETFramework, versione = v4.7.1 "".NETFramework,Version=v4.7.1"
4.7.24.7.2 ". NETFramework, versione = v4.7.2 "".NETFramework,Version=v4.7.2"

EsempioExample

L'esempio seguente illustra come specificare la versione di runtime in un file di configurazione.The following example shows how to specify the supported runtime version in a configuration file. Il file di configurazione indica che l'app è destinata la 4.7 di .NET Framework.The configuration file indicates that the app targets the .NET Framework 4.7.

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

File di configurazioneConfiguration file

L'elemento può essere utilizzato nel file di configurazione dell'applicazione.This element can be used in the application configuration file.

Vedere ancheSee also

Schema delle impostazioni di avvioStartup Settings Schema
Schema dei file di configurazioneConfiguration File Schema
In-Process Side-by-Side Execution (Esecuzione side-by-side In-Process)In-Process Side-by-Side Execution