<startup>, élément<startup> element

Spécifie common language runtime informations de démarrage.Specifies common language runtime startup information.

<configuration>
  <startup>

SyntaxeSyntax

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

Attributs et élémentsAttributes and elements

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.The following sections describe attributes, child elements, and parent elements.

AttributsAttributes

AttributAttribute DescriptionDescription
useLegacyV2RuntimeActivationPolicy Attribut facultatif.Optional attribute.

Spécifie s’il faut activer la stratégie d’activation du Runtime .NET Framework 2,0 ou utiliser la stratégie d’activation .NET Framework 4.Specifies whether to enable the .NET Framework 2.0 runtime activation policy or to use the .NET Framework 4 activation policy.

useLegacyV2RuntimeActivationPolicy (attribut)useLegacyV2RuntimeActivationPolicy attribute

ValueValue DescriptionDescription
true Activez .NET Framework stratégie d’activation du runtime 2,0 pour le runtime choisi, qui consiste à lier les techniques héritées d’activation du Runtime (telles que la fonction CorBindToRuntimeEx) au runtime choisi à partir du fichier de configuration au lieu de les découper au niveau du CLR version 2,0.Enable .NET Framework 2.0 runtime activation policy for the chosen runtime, which is to bind legacy runtime activation techniques (such as the CorBindToRuntimeEx function) to the runtime chosen from the configuration file instead of capping them at CLR version 2.0. Par conséquent, si CLR version 4 ou ultérieure est choisi dans le fichier de configuration, les assemblys en mode mixte créés avec des versions antérieures du .NET Framework sont chargés avec la version CLR choisie.Thus, if CLR version 4 or later is chosen from the configuration file, mixed-mode assemblies created with earlier versions of the .NET Framework are loaded with the chosen CLR version. La définition de cette valeur empêche le chargement du CLR version 1,1 ou CLR version 2,0 dans le même processus, ce qui a pour effet de désactiver la fonctionnalité côte à côte in-process.Setting this value prevents CLR version 1.1 or CLR version 2.0 from loading into the same process, effectively disabling the in-process side-by-side feature.
false Utilisez la stratégie d’activation par défaut pour le .NET Framework 4 et versions ultérieures, ce qui permet d’autoriser les techniques d’activation du runtime héritées à charger CLR version 1,1 ou 2,0 dans le processus.Use the default activation policy for the .NET Framework 4 and later, which is to allow legacy runtime activation techniques to load CLR version 1.1 or 2.0 into the process. La définition de cette valeur empêche le chargement des assemblys en mode mixte dans le .NET Framework 4 ou ultérieur, sauf s’ils ont été générés avec le .NET Framework 4 ou version ultérieure.Setting this value prevents mixed-mode assemblies from loading into the .NET Framework 4 or later unless they were built with the .NET Framework 4 or later. Il s’agit de la valeur par défaut.This value is the default.

Éléments enfantsChild elements

ÉlémentElement DescriptionDescription
<requiredRuntime> Spécifie que l’application prend en charge uniquement la version 1.0 du common language runtime.Specifies that the application supports only version 1.0 of the common language runtime. Les applications générées avec la version 1,1 ou ultérieure du Runtime doivent utiliser l' <supportedRuntime> élément.Applications built with runtime version 1.1 or later should use the <supportedRuntime> element.
<supportedRuntime> Spécifie quelles versions du Common Language Runtime sont prises en charge par l'application.Specifies which versions of the common language runtime the application supports.

Éléments parentsParent elements

ÉlémentElement DescriptionDescription
configuration Élément racine de chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.The root element in every configuration file used by the common language runtime and .NET Framework applications.

NotesRemarks

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.

Le code de démarrage d’une application hébergée dans Microsoft Internet Explorer ignore l' <startup> élément et ses éléments enfants.The startup code for an application hosted in Microsoft Internet Explorer ignores the <startup> element and its child elements.

Attribut useLegacyV2RuntimeActivationPolicyThe useLegacyV2RuntimeActivationPolicy attribute

Cet attribut est utile 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 au lieu d’une version antérieure, ou si votre application est générée avec l' .NET Framework 4, mais qu’elle a une dépendance sur un assembly en mode mixte créé avec une version antérieure du .NET Framework.This attribute is useful 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 but has a dependency on a mixed-mode assembly built with an earlier version of the .NET Framework. Dans ces scénarios, affectez à l’attribut la valeur true .In those scenarios, set the attribute to true.

Notes

L’affectation de la valeur à l’attribut true empêche le chargement du CLR version 1,1 ou CLR version 2,0 dans le même processus, ce qui a pour effet de désactiver la fonctionnalité côte à côte in-process (voir exécution côte à côte pour COM Interop).Setting the attribute to true prevents CLR version 1.1 or CLR version 2.0 from loading into the same process, effectively disabling the in-process side-by-side feature (see Side-by-Side Execution for COM Interop).

 ExempleExample

L’exemple suivant montre comment spécifier la version du runtime dans un fichier de configuration.The following example shows how to specify the runtime version in a configuration file.

<!-- 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 aussiSee also