Comment : configurer le runtime du .NET Framework 4

Article
08/10/2011

Cette rubrique décrit comment configurer vos applications .NET Framework pour les exécuter sur le .NET Framework version 4 sans les recompiler.

Pour exécuter une application sur le .NET Framework 4

Dans le dossier qui contient le fichier .exe de votre application, créez un fichier de configuration de l'application avec les éléments suivants :
```
<configuration>
   <startup>
      <supportedRuntime version="v4.0"/>
   </startup>
</configuration>
```
Pour plus d'informations sur ces éléments, consultez <startup>, élément et <supportedRuntime>, élément.
Exécutez votre application.

Pour exécuter un complément sur le .NET Framework 4

Dans le dossier qui contient le fichier .exe de votre complément, créez un fichier XML avec les éléments suivants :
```
<configuration>
   <startup useLegacyV2RuntimeActivationPolicy="true">
      <supportedRuntime version="v4.0"/>
   </startup>
</configuration>
```
L'attribut useLegacyV2RuntimeActivationPolicy pour l'<startup>, élément doit avoir la valeur true.
Démarrez votre application et exécutez le complément.

Pour exécuter une application Web sur le .NET Framework 4

Précompilez votre application Web sur l'ordinateur qui exécute la version antérieure du .NET Framework avec lequel l'application a été générée. Vous pouvez le faire en exécutant l'outil de compilation ASP.NET, qui se trouve dans le répertoire [%WinDir%]\Microsoft.Net\Framework\[.NET Framework Version]\, à l'aide de la syntaxe suivante :

aspnet_compiler -v /[ApplicationName] [Destination Directory]

Par exemple, pour précompiler l'application Web nommée ExampleWebApp et mettre l'assembly résultant dans le répertoire C:\WebApps, utilisez la commande suivante :

aspnet_compiler -v /ExampleWebApp c:\WebApps

Pour plus d'informations sur ce processus, consultez Comment : précompiler des projets de sites Web ASP.NET.
Copiez l'assembly de site Web compilé vers un ordinateur sur lequel le .NET Framework 4 est installé.

Remarque

Vous pouvez également installer l'application Web qui cible une version antérieure du .NET Framework sur l'ordinateur sur lequel le .NET Framework 4 est installé.
Vérifiez que le .NET Framework 4 est installé et activé. Exécutez l'outil ASP.NET d'inscription en utilisant la commande suivante dans le répertoire .NET Framework 4 :

aspnet_regiis –i –enable

Pour plus d'informations sur cet outil, consultez ASP.NET IIS Registration, outil (Aspnet_regiis.exe).
Vérifiez que les pools d'applications ciblent le .NET Framework 4.

L'application Web est maintenant configurée pour s'exécuter sur le .NET Framework 4.

Remarque
Vous pouvez également installer l'application Web qui cible une version antérieure du .NET Framework sur l'ordinateur sur lequel le .NET Framework 4 est installé.

Pour exécuter une application ClickOnce sur le .NET Framework 4

Ajoutez un élément compatibleFrameworks au manifeste de déploiement de votre application ClickOnce :

<compatibleFrameworks xmlns="urn:schemas-microsoft-com:clickonce.v2"> 
  <framework profile="Full" targetVersion="4.0" 
      supportedRuntime="4.0.0" />
</compatibleFrameworks>

Si vous souhaitez que votre application exécute le .NET Framework 4 Client Profile, utilisez la configuration suivante :

<compatibleFrameworks xmlns="urn:schemas-microsoft-com:clickonce.v2"> 
  <framework profile="Client" targetVersion="4.0" 
      supportedRuntime="4.0.0" />
</compatibleFrameworks>

Pour plus d'informations sur le déploiement ClickOnce, consultez <compatibleFrameworks>, élément (Déploiement ClickOnce).

Mettez à jour le fichier de configuration de votre application pour qu'il contienne l'élément supportedRuntime :
```
<configuration>
   <startup>
      <supportedRuntime version="v4.0"/>
   </startup>
</configuration>
```
Mettez à jour la référence de fichier existant dans le manifeste de l'application pour inclure le fichier de configuration :

<file name="[application file name].exe.config" size="[config file size]">
Utilisez l'outil Manifest Generation and Editing (Mage.exe) pour mettre à jour le hachage dans le manifeste d'application :

Mage –update [path to application manifest]

Pour plus d'informations sur cette commande, consultez Mage.exe (outil Manifest Generation and Editing).
Signez le manifeste d'application mis à jour :

Mage –Sign [path to application manifest] –CertFile [path to .pfx file]
Mettez à jour le manifeste de déploiement :

Mage –update [path to deployment manifest] –AppManifest [path to application manifest]
Signez le manifeste de déploiement mis à jour :

Mage –Sign [path to deployment manifest] –CertFile [path to .pfx file]

L'application ClickOnce est maintenant configurée pour s'exécuter sur le .NET Framework 4.

Voir aussi

Autres ressources

Guide de migration du .NET Framework 4

Partager via