<supportedRuntime>, élément<supportedRuntime> element

Spécifie la version de common language runtime et, éventuellement, la version .NET Framework prise en charge par l’application.Specifies which common language runtime version and, optionally, .NET Framework version the application supports.

<configuration>
  <startup>
    <supportedRuntime>

SyntaxeSyntax

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

AttributsAttributes

AttributAttribute DescriptionDescription
versionversion Attribut facultatif.Optional attribute.

Valeur de chaîne qui spécifie la version du Common Language Runtime (CLR) prise en charge par cette application.A string value that specifies the version of the common language runtime (CLR) that this application supports. Pour connaître les valeurs valides de l' version attribut, consultez la section valeurs de la « version du runtime » .For valid values of the version attribute, see the "runtime version" values section. Remarque : Par le biais du .NET Framework 3,5, la valeur «version du runtime» prend la forme principale. mineure. générer.Note: Through the .NET Framework 3.5, the "runtime version" value takes the form major.minor.build. À partir du .NET Framework 4, seuls les numéros de version majeure et mineure sont requis (autrement dit, « v 4.0 » au lieu de « v 4.0.30319 »).Beginning with the .NET Framework 4, only the major and minor version numbers are required (that is, "v4.0" instead of "v4.0.30319"). La chaîne courte est recommandée.The shorter string is recommended.
skusku Attribut facultatif.Optional attribute.

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

À compter du .NET Framework 4.0, l’utilisation de l’attribut sku est recommandée.Starting with the .NET Framework 4.0, the use of the sku attribute is recommended. Quand il est présent, il indique la version du .NET Framework ciblée par l’application.When present, it indicates the version of the .NET Framework that the app targets.

Pour connaître les valeurs valides de l’attribut SKU, consultez la section « Réf SKU » .For valid values of the sku attribute, see the "sku id" values section.

RemarquesRemarks

Si l' <supportedRuntime> élément n’est pas présent dans le fichier de configuration de l’application, la version du runtime utilisée pour générer l’application est utilisée.If the <supportedRuntime> element is not present in the application configuration file, the version of the runtime used to build the application is used.

L' <supportedRuntime> élément doit être utilisé par toutes les applications générées à l’aide de la version 1,1 ou ultérieure du Runtime.The <supportedRuntime> element should be used by all applications built using version 1.1 or later of the runtime. Les applications générées pour prendre en charge uniquement la version 1,0 du Runtime doivent utiliser l' <requiredRuntime> élément.Applications built to support only version 1.0 of the runtime must use the <requiredRuntime> element.

Notes

Si vous utilisez la fonction CorBindToRuntimeByCfg pour spécifier le fichier de configuration, vous devez utiliser l' <requiredRuntime> élément pour toutes les versions du Runtime.If you use the CorBindToRuntimeByCfg function to specify the configuration file, you must use the <requiredRuntime> element for all versions of the runtime. L' <supportedRuntime> élément est ignoré lorsque vous utilisez CorBindToRuntimeByCfg.The <supportedRuntime> element is ignored when you use 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.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. Pour les applications qui prennent en charge le .NET Framework 4,0 ou versions ultérieures, l' version attribut indique la version du CLR, qui est commune à la .NET Framework 4 et versions ultérieures, et l' sku attribut indique la version de .NET Framework unique ciblée par l’application.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 the single .NET Framework version that the app targets.

Si l' <supportedRuntime> élément avec l' sku attribut est présent dans le fichier de configuration et que la version de .NET Framework installée est inférieure à la version prise en charge spécifiée, l’application ne s’exécute pas et affiche à la place un message demandant à d’installer la version prise en charge.If the <supportedRuntime> element with the sku attribute is present in the configuration file and the installed .NET Framework version is lower then the specified supported version, the application fails to run and instead displays a message asking to install the supported version. Dans le cas contraire, l’application tente de s’exécuter sur n’importe quelle version installée, mais elle peut se comporter de façon inattendue si elle n’est pas entièrement compatible avec cette version.Otherwise, the application attempts to run on any installed version, but it may behave unexpectedly if it is not fully compatible with that version. (Pour connaître les différences de compatibilité entre les versions de .NET Framework, consultez compatibilité des applications dans le .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’erreur.(For compatibility differences between versions of .NET Framework, see Application compatibility in the .NET Framework.) Therefore, we recommend that you include this element in the application configuration file for easier error diagnostics. (Le fichier de configuration généré automatiquement par Visual Studio lors de la création d’un projet le contient déjà.)(The configuration file automatically generated by Visual Studio when creating a new project already contains it.)

Notes

Si votre application utilise des chemins d’activation hérités, tels que la fonction CorBindToRuntimeEx, et que vous souhaitez que ces chemins activent la version 4 du CLR au lieu d’une version antérieure, ou si votre application est générée avec l' .NET Framework 4, mais qu’elle dépende d’un assembly en mode mixte créé avec une version antérieure du .NET Framework, il n’est pas suffisant de spécifier le .NET Framework 4 dansIf 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 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 in the list of supported runtimes. En outre, dans l' <startup> élément de votre fichier de configuration, vous devez affecter useLegacyV2RuntimeActivationPolicy à l’attribut la valeur true .In addition, in the <startup> element in your configuration file, you must set the useLegacyV2RuntimeActivationPolicy attribute to true. Toutefois, l’affectation de la valeur à cet attribut true signifie que tous les composants générés avec des versions antérieures du .NET Framework sont exécutés à l’aide du .NET Framework 4 au lieu des runtimes avec lesquels ils ont été générés.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 instead of the runtimes they were built with.

Nous vous recommandons de tester les applications avec toutes les versions du .NET Framework sur lesquelles elles peuvent s'exécuter.We recommend that you test applications with all the .NET Framework versions that they can run on.

valeurs de "runtime version""runtime version" values

L' runtime attribut spécifie la version du Common Language Runtime (CLR) qui est requise pour une application donnée.The runtime attribute specifies the Common Language Runtime (CLR) version that is required for a given application. Notez que toutes les versions .NET Framework v4. x spécifient le v4.0 CLR.Note that all .NET Framework v4.x versions specify the v4.0 CLR. Le tableau suivant répertorie les valeurs valides pour la valeur de la version du runtime de l' version attribut.The following table lists valid values for the runtime version value of the version attribute.

Version du .NET Framework.NET Framework version Attribut 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.0-4.84.0-4.8 "v4.0""v4.0"

valeurs « SKU ID »"sku id" values

L' sku attribut utilise un moniker de Framework cible (TFM) pour indiquer la version de l' .NET Framework que l’application cible et nécessite d’exécuter.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. Le tableau suivant répertorie les valeurs valides prises en charge par l' sku attribut, à partir de la .NET Framework 4.The following table lists valid values that are supported by the sku attribute, starting with the .NET Framework 4.

Version du .NET Framework.NET Framework version Attribut 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, Platform Update 14.0, platform update 1 ". NETFramework, version = v 4.0.1 "".NETFramework,Version=v4.0.1"
4.0, Client Profile, Update 14.0, Client Profile, update 1 ". NETFramework, version = v 4.0.1, Profile = client "".NETFramework,Version=v4.0.1,Profile=Client"
4.0, Platform Update 24.0, platform update 2 ". NETFramework, version = v 4.0.2»".NETFramework,Version=v4.0.2"
4.0, Client Profile, Update 24.0, Client Profile, update 2 ". NETFramework, version = v 4.0.2, Profile = client "".NETFramework,Version=v4.0.2,Profile=Client"
4.0, Platform Update 34.0, platform update 3 ". NETFramework, version = v 4.0.3»".NETFramework,Version=v4.0.3"
4.0, Client Profile, Update 34.0, Client Profile, update 3 ". NETFramework, version = v 4.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 = v 4.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, version = v 4.7.1 "".NETFramework,Version=v4.7.1"
4.7.24.7.2 ". NETFramework, version = v 4.7.2 "".NETFramework,Version=v4.7.2"
4.84.8 ". NETFramework, version = v 4.8".NETFramework,Version=v4.8"

ExempleExample

L’exemple suivant montre comment spécifier la version du runtime prise en charge dans un fichier de configuration.The following example shows how to specify the supported runtime version in a configuration file. Le fichier de configuration indique que l’application cible le .NET Framework 4,7.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>

Fichier de configurationConfiguration file

Cet élément peut être utilisé dans le fichier de configuration de l'application.This element can be used in the application configuration file.

Voir aussiSee also