Élément <supportedRuntime>

  • Article

Spécifie la version du common language runtime et, éventuellement, la version de .NET Framework prise en charge par l’application.

<configuration>
  <startup>
    <supportedRuntime>

Syntaxe

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

Attributs

Attribut Description
version Attribut facultatif.

Valeur de chaîne qui spécifie la version du Common Language Runtime (CLR) prise en charge par cette application. Pour les valeurs valides de l’attribut version, consultez la section valeurs de « version du runtime ». Remarque : Dans .NET Framework 3.5, la valeur de « version du runtime » prend la forme major.minor.build. Depuis .NET Framework 4, seuls les numéros de version principale et secondaire sont nécessaires (c'est-à-dire « v4.0 » au lieu de « v4.0.30319 »). La chaîne courte est recommandée.
sku Attribut facultatif.

Valeur de chaîne qui spécifie la référence (SKU), qui à son tour spécifie quelle mise en production du .NET Framework cette application prend en charge.

À compter de .NET Framework 4.0, l’utilisation de l’attribut sku est recommandée. Quand il est présent, il indique la version du .NET Framework ciblée par l’application.

Pour les valeurs valides de l’attribut sku, consultez la section valeurs « ID SKU ».

Notes

Si l'élément <supportedRuntime> n'est pas dans le fichier de configuration de l'application, la version du runtime utilisée pour générer l'application est utilisée.

L'élément <supportedRuntime> doit être utilisé par toutes les applications générées à l'aide de la version 1.1 du runtime ou ultérieure. Les applications générées pour prendre en charge uniquement la version 1.0 du runtime doivent utiliser l'élément <requiredRuntime>.

Notes

Si vous utilisez la fonction CorBindToRuntimeByCfg pour spécifier le fichier de configuration, vous devez employer l’élément <requiredRuntime> pour toutes les versions du runtime. L'élément <supportedRuntime> est ignoré lorsque vous utilisez CorBindToRuntimeByCfg.

Pour les applications prenant en charge les versions du runtime du .NET Framework 1.1 à 3.5, quand plusieurs versions du runtime sont prises en charge, le premier élément doit spécifier la version du runtime préférée en premier tandis que le dernier élément doit spécifier la version préférée en dernier. Pour les applications prenant en charge .NET Framework 4.0 ou ultérieur, l’attribut version indique la version du CLR, qui est commune au .NET Framework 4 et aux versions ultérieures tandis que l’attribut sku indique la seule version de .NET Framework ciblée par l’application.

Si l’élément <supportedRuntime> avec l’attribut sku est présent dans le fichier de configuration et que la version .NET Framework installée est inférieure à la version prise en charge spécifiée, l’application ne parvient pas à s’exécuter et affiche un message demandant d’installer la version prise en charge. Sinon, l’application tente de s’exécuter sur n’importe quelle version installée, mais elle peut se comporter de manière inattendue s’elle n’est pas entièrement compatible avec cette version. (Pour connaître les différences de compatibilité entre les versions de .NET Framework, voir Compatibilité des applications dans .NET Framework.) Par conséquent, nous vous recommandons d’inclure cet élément dans le fichier de configuration de l’application pour faciliter les diagnostics d’erreurs. (Le fichier de configuration généré automatiquement par Visual Studio lors de la création d’un projet le contient déjà.)

Notes

Si votre application utilise des chemins d’activation hérités, tels que la fonction CorBindToRuntimeEx, et si vous souhaitez que ces chemins activent la version 4 du CLR plutôt qu’une version antérieure, ou si votre application est générée avec .NET Framework 4, mais a une dépendance sur un assembly de mode mixte généré avec une version antérieure de .NET Framework, il ne suffit pas de spécifier .NET Framework 4 dans la liste des runtimes pris en charge. De plus, dans l'élément <startup> de votre fichier de configuration, vous devez définir l'attribut useLegacyV2RuntimeActivationPolicy sur true. Toutefois, l'affectation de la valeur true à cet attribut signifie que tous les composants générés avec des versions antérieures du .NET Framework sont exécutés à l'aide de .NET Framework 4 plutôt qu'à l'aide des runtimes avec lesquels ils ont été générés.

Nous vous recommandons de tester les applications avec toutes les versions du .NET Framework sur lesquelles elles peuvent s'exécuter.

valeurs de "runtime version"

L’attribut runtime spécifie la version Common Language Runtime (CLR) requise pour une application donnée. Toutes les versions de .NET Framework v4.x spécifient le CLR v4.0. Le tableau suivant répertorie les valeurs valides pour la valeur version du runtime de l’attribut version.

Version du .NET Framework Attribut 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"

Valeurs de « ID SKU »

L’attribut sku utilise un moniker de framework cible (TFM) pour indiquer la version de .NET Framework que l’application cible et dont elle a besoin pour s’exécuter. Le tableau suivant répertorie les valeurs valides prises en charge par l’attribut sku, à compter de .NET Framework 4.

Version du .NET Framework Attribut sku
4.0 ".NETFramework,Version=v4.0"
4.0, Client Profile ".NETFramework,Version=v4.0,Profile=Client"
4.0, Platform Update 1 ".NETFramework,Version=v4.0.1"
4.0, Client Profile, Update 1 ".NETFramework,Version=v4.0.1,Profile=Client"
4.0, Platform Update 2 ".NETFramework,Version=v4.0.2"
4.0, Client Profile, Update 2 ".NETFramework,Version=v4.0.2,Profile=Client"
4.0, Platform Update 3 ".NETFramework,Version=v4.0.3"
4.0, Client Profile, Update 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"

Exemple

L’exemple suivant montre comment spécifier la version du runtime prise en charge dans un fichier de configuration. Le fichier de configuration indique que l’application cible .NET Framework 4.7.

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

Fichier de configuration

Cet élément peut être utilisé dans le fichier de configuration de l'application.

Voir aussi