Partager via

Gestion de plusieurs versions de ASP.NET

  • Article

Le .NET Framework vous permet d'installer plusieurs versions du runtime sur le même ordinateur. Cela permet à une application ASP.NET d'utiliser la version nécessaire à l'exécution sans affecter d'autres applications. Les sections suivantes décrivent comment installer, désinstaller et redistribuer plusieurs versions de ASP.NET sur le même ordinateur.

Installation de plusieurs versions de ASP.NET

Pour ajouter une version de ASP.NET à un ordinateur, exécutez le programme d'installation du package redistribuable .NET Framework (Dotnetfx.exe) pour la version que vous voulez installer. Par défaut, toutes les applications ASP.NET existantes sont automatiquement reconfigurées lors de l'installation afin d'utiliser la version d'installation du runtime si les conditions suivantes sont remplies :

  • La version .NET Framework d'installation est une version ultérieure par rapport à la version actuellement mappée sur l'application.

  • La version .NET Framework d'installation est compatible avec la version mappée sur l'application. En général, le numéro de version détermine la compatibilité. Les révisions et changements secondaires de numéro de build sont habituellement compatibles, tandis que les numéros de révision principaux ne le sont pas.

    ATTENTION   Bien que les applications ASP.NET soient mises à jour automatiquement pour utiliser la version d'installation de ASP.NET si les conditions précédentes sont remplies, les paramètres de configuration personnalisés dans le fichier Machine.config en cours ne sont pas transférés vers le fichier Machine.config d'installation. Si votre application utilise des paramètres de configuration personnalisés, veillez à soit mettre à jour manuellement le nouveau Machine.config, soit utilisez l'outil ASP.NET IIS Registration (Aspnet_regiis.exe) pour remapper l'application sur la version précédente de ASP.NET. Pour plus d'informations sur le remappage d'une application, consultez Configuration d'une application ASP.NET pour une version ASP.NET.

Pour éviter le remappage automatique de toutes les applications existantes sur la version d'installation du .NET Framework, utilisez l'option de ligne de commande /noaspupgrade avec le programme d'installation Dotnetfx.exe. Le code suivant illustre la ligne de commande complète.

Dotnetfx.exe /c:"install /noaspupgrade"

Pour plus d'informations sur le package redistribuable .NET Framework, consultez Redistribution du .NET Framework.

Console Security Lockdown dans IIS 6.0

Si vous utilisez Internet Information Services 6.0, vous devrez peut-être activer ASP.NET dans la console de gestion IIS après l'installation de ASP.NET. IIS 6.0 introduit une nouvelle console security lockdown ce qui permet à un administrateur d'activer et désactiver de manière sélective les fonctionnalités dans IIS. Lorsque ASP.NET version 1.1 ou supérieure est installé sur un ordinateur qui utilise IIS 6.0, le script d'installation crée une clé de métabase pour cette version de ASP.NET. Cette clé de métabase permet à ASP.NET de s'afficher dans la console sous la forme de composant configurable. Une clé séparée est créée pour chaque version installée de ASP.NET ce qui permet à chaque version d'être configurable séparément dans la console. Lorsqu'une version de ASP.NET est désinstallée d'un ordinateur, la clé respective est également supprimée.

Remarque   Lorsque ASP.NET est installé par l'intermédiaire de l'élément Ajout/Suppression de programmes dans le Panneau de configuration ou l'Assistant Configurer votre Serveur, ASP.NET est activé dans la console security lockdown par défaut. Cependant, s'il est installé via Microsoft Visual Studio .NET, Windows Update ou le package redistribuable .NET Framework (Dotnetfx.exe), ASP.NET est désactivé par défaut.

Pour gérer des éléments dans la console security lockdown

  1. Ouvrez la console de gestion IIS.
  2. Développez l'ordinateur local en cliquant sur le signe plus.
  3. Cliquez sur le dossier extensions du service Web. La console security lockdown s'affiche dans le volet droit.
  4. Sélectionnez l'onglet Étendu, cliquez sur l'élément Extension du service Web que vous souhaitez configurer.
  5. Cliquez sur le bouton Autoriser ou Interdire pour activer ou désactiver l'élément.
  6. Cliquez sur le lien Ajouter une nouvelle extension de service Web pour ajouter un nouvel élément à la console.

Désinstallation d'une version de ASP.NET

Si vous avez plusieurs versions de ASP.NET installées sur un ordinateur, vous pouvez désinstaller une version individuellement. La désinstallation de ASP.NET s'effectue habituellement en désinstallant le .NET Framework via l'élément Ajout/Suppression de programmes dans le Panneau de configuration. Lors du processus de désinstallation, le programme d'installation appelle l'outil ASP.NET IIS Registration (Aspnet_regiis.exe) avec l'option -u (indicateur de désinstallation).

Remarque   Si vous souhaitez simplement désinstaller une version de ASP.NET sans désinstaller le .NET Framework associé, vous pouvez utiliser Aspnet_regiis.exe directement. Chaque installation du .NET Framework contient une version associée de l'outil. Pour désinstaller ASP.NET uniquement, utilisez l'option -u de la version de l'outil associée à la version ASP.NET que vous souhaitez désinstaller. Pour plus d'informations, consultez Outil ASP.NET IIS Registration Tool (Aspnet_regiis.exe).

L'option -u de Aspnet_regiis.exe effectue les actions suivantes :

  • Toutes les applications ASP.NET mappées actuellement sur la version ASP.NET en cours de désinstallation sont remappées sur la version la plus compatible présente sur l'ordinateur. Si aucune version compatible n'existe, le scriptmap pour l'application est supprimé complètement.

    ATTENTION   La suppression des scriptmaps amènera IIS à servir les pages ASP.NET sous forme de texte littéral. Cela risque d'exposer du code source au client.

  • Le service d'état ASP.NET est partagé entre toutes les versions compatibles de ASP.NET et est toujours mappé sur la dernière version installée de ASP.NET. Si la version ASP.NET que vous désinstallez correspond actuellement à la dernière version, la version la plus compatible présente sur l'ordinateur est ensuite inscrite pour la remplacer. S'il n'existe aucune version compatible, le service d'état ASP.NET est désinstallé.

  • Les objets de performance et leurs compteurs de performance associés propres à la version en cours de désinstallation sont supprimés. Les objets et compteurs de performance génériques qui s'appliquent à toutes les versions installées de ASP.NET, ASP.NET et ASP.NET Applications, sont dirigés vers la dernière version installée restante sur l'ordinateur.

  • Le compte d'utilisateur ASPNET est partagé entre toutes les versions compatibles de ASP.NET. Si aucune installation ASP.NET supplémentaire ne reste sur l'ordinateur, le compte d'utilisateur ASPNET et les listes de contrôle d'accès associées sont supprimés.

Pour plus d'informations sur d'autres effets liés à l'installation de plusieurs versions de ASP.NET, consultez Vue d'ensemble de l'exécution côte à côte dans ASP.NET.

Redistribution tierce du .NET Framework

Les applications tierces peuvent empaqueter et installer le .NET Framework comme partie intégrante de leur programme d'installation dans le cadre d'une licence de redistribution spéciale. Une application peut ainsi installer la version spécifique du .NET Framework dont elle a besoin pour s'exécuter. Le package redistribuable du .NET Framework (Dotnetfx.exe) est fourni pour qu'une application se déploie avec le runtime. Le script d'installation par défaut de Dotnetfx.exe peut ne pas convenir aux besoins de votre application. Il appartient au développeur d'application tierce d'utiliser les options décrites ci-dessous lors de l'installation du .NET Framework dans le cadre du programme d'installation d'une application.

Pour plus d'informations sur le package redistribuable .NET Framework, consultez Redistribution du .NET Framework. Pour plus d'informations sur le CLUF du package redistribuable, consultez Où se procurer le package redistribuable .NET Framework.

Désactivation des mises à jour de scriptmap automatiques

Par défaut, lorsque le .NET Framework est installé sur un ordinateur avec une installation existante, toutes les applications ASP.NET sont automatiquement mises à jour pour utiliser cette version du .NET Framework, sauf si les applications sont liées à une version incompatible du runtime ou à une version ultérieure du runtime. Généralement, seul un administrateur système effectue ce type d'installation. Lorsque le .NET Framework est installé dans le cadre du programme d'installation d'une application, il ne doit pas forcer d'autres applications sur l'ordinateur à utiliser cette version du runtime.

Dans le cadre du script d'installation, Dotnetfx.exe appelle normalement l'outil ASP.NET IIS Registration (Aspnet_regiis.exe) à l'aide de l'option -i pour installer ASP.NET. Cette option tente de mettre à jour les scriptmaps de toutes les applications ASP.NET existantes. Pour empêcher l'installation de mettre à jour d'autres applications sur l'ordinateur, l'option /noaspnetupgrade est fournie dans le cadre de Dotnetfx.exe. Cette option entraîne, à la place, l'utilisation par le programme d'installation de l'option -ir de Aspnet_regiis.exe, ce qui ignore les mises à jour de scriptmap automatiques, la documentation par défaut et les étapes de permutation MIME. Le code suivant illustre la ligne de commande complète.

Dotnetfx.exe /c:"install /noaspupgrade"

Mise à jour manuelle des scriptmaps

Il est parfois nécessaire de configurer manuellement les scriptmaps pour une application. Si l'application a besoin de son propre répertoire virtuel qui cible la version d'installation du .NET Framework, veillez à ce que le programme d'installation de l'application appelle également Aspnet_regiis.exe de manière explicite à l'aide de l'option -s ou -sn pour configurer les scriptmaps.

Ce qui suit illustre un exemple de ligne de commande qui met à jour les scriptmaps pour une application nommée SampleApp1.

Aspnet_regiis.exe -s W3SVC/1/ROOT/SampleApp1

Pour plus d'informations, consultez Outil ASP.NET IIS Registration Tool (Aspnet_regiis.exe).

Voir aussi

Prise en charge de l'exécution côte à côte dans ASP.NET | Outil ASP.NET IIS Registration Tool (Aspnet_regiis.exe) | Redistribution du .NET Framework | Où se procurer le package redistribuable .NET Framework