Partage via

<startup>, élément

  • Article

Spécifie les informations de démarrage du CLR (Common Language Runtime).

<configuration>
  <startup>

Syntaxe

<startup useLegacyV2RuntimeActivationPolicy="true|false" >
</startup>

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut Description
useLegacyV2RuntimeActivationPolicy Attribut facultatif.

Spécifie s’il faut activer la stratégie d’activation du runtime .NET Framework 2.0 ou utiliser la stratégie d’activation de .NET Framework 4.

Attribut useLegacyV2RuntimeActivationPolicy

Valeur Description
true Activez la stratégie d’activation du runtime .NET Framework 2.0 pour le runtime choisi, qui consiste à lier les techniques d’activation du runtime héritées (telles que la fonction CorBindToRuntimeEx) au runtime choisi à partir du fichier de configuration au lieu de les limiter à la version 2.0 du CLR. Ainsi, si la version 4 ou ultérieure du CLR est choisie dans le fichier de configuration, les assemblys en mode mixte créés avec des versions antérieures de .NET Framework sont chargés avec la version choisie du CLR. La définition de cette valeur empêche le chargement de la version 1.1 ou 2.0 du CLR dans le même processus, ce qui désactive la fonctionnalité côte à côte in-process.
false Pour .NET Framework 4 et versions ultérieures, utilisez la stratégie d’activation par défaut, qui consiste à autoriser les techniques d’activation du runtime héritées à charger la version 1.1 ou 2.0 du CLR dans le processus. La définition de cette valeur empêche le chargement des assemblys en mode mixte dans .NET Framework 4 ou version ultérieure, sauf s’ils ont été générés avec .NET Framework 4 ou version ultérieure. Cette valeur est la valeur par défaut.

Éléments enfants

Élément Description
<requiredRuntime> Spécifie que l’application prend en charge uniquement la version 1.0 du common language runtime. Les applications générées avec la version 1.1 ou ultérieure du runtime doivent utiliser l’élément <supportedRuntime>.
<supportedRuntime> Spécifie quelles versions du Common Language Runtime sont prises en charge par l'application.

Éléments parents

Élément Description
configuration Élément racine de chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.

Notes

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

Attribut useLegacyV2RuntimeActivationPolicy

Cet attribut est utile 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 plutôt qu’une version antérieure, ou si votre application est générée avec .NET Framework 4, mais présente une dépendance vis-à-vis d’un assembly en mode mixte généré avec une version antérieure de .NET Framework. Dans ces scénarios, définissez l’attribut sur true.

Notes

La définition de l’attribut sur true empêche le chargement de la version 1.1 ou 2.0 du CLR dans le même processus, ce qui désactive la fonctionnalité côte à côte in-process (voir Exécution côte à côte pour COM Interop).

Exemple

L’exemple suivant montre comment spécifier la version du runtime dans un fichier de configuration.

<!-- When used with version 1.0 of the .NET Framework runtime -->
<configuration>
   <startup>
      <requiredRuntime version="v1.0.3705" safemode="true"/>
   </startup>
</configuration>
<!-- When used with version 1.1 (or later) of the runtime -->
<configuration>
   <startup>
      <supportedRuntime version="v1.1.4322"/>
      <supportedRuntime version="v1.0.3705"/>
   </startup>
</configuration>

Voir aussi