Élément <requiredRuntime>

  • Article

Spécifie que l’application prend en charge uniquement la version 1.0 du common language runtime. Cet élément est déconseillé et ne doit plus être utilisé. Il est préférable d’utiliser l’élément supportedRuntime.

<configuration>
  <startup>
    <requiredRuntime>

Syntaxe

   <requiredRuntime  
version="runtime version"
safemode="true|false"/>

Attributs et éléments

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

Attributs

Attribut Description
version Attribut facultatif.

Valeur de chaîne qui spécifie la version de .NET Framework prise en charge par cette application. La valeur de chaîne doit correspondre au nom du répertoire trouvé sous la racine d’installation de .NET Framework. Le contenu de la valeur de chaîne n’est pas analysé.
safemode Attribut facultatif.

Spécifie si le code de démarrage du runtime recherche dans le Registre pour déterminer la version du runtime.

attribut safemode

Valeur Description
false Le code de démarrage du runtime recherche dans le Registre. Il s’agit de la valeur par défaut.
true Le code de démarrage du runtime ne cherche pas dans le Registre.

Éléments enfants

Aucune.

É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.
startup Contient l’élément <requiredRuntime>.

Notes

Les applications générées pour prendre en charge uniquement la version 1.0 du runtime doivent utiliser l’élément <requiredRuntime>. Les applications générées à l’aide de la version 1.1 ou ultérieure du runtime doivent utiliser l’élément <supportedRuntime>.

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.

La chaîne d’attribut version doit correspondre au nom du dossier d’installation de la version spécifiée de .NET Framework. Cette chaîne n’est pas interprétée. Si le code de démarrage du runtime ne trouve pas de dossier correspondant, le runtime n’est pas chargé ; le code de démarrage affiche un message d’erreur et quitte.

Exemple

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

<configuration>
   <startup>
      <requiredRuntime version="v1.0.3705" safemode="true"/>
   </startup>
</configuration>

Voir aussi