Configuration d'une application ASP.NET pour une version ASP.NET
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. Les seules exceptions concernent des applications qui sont liées à une version incompatible du runtime ou à une version ultérieure du runtime. Même si les versions ultérieures du .NET Framework sont conçues pour être compatibles en amont, vous souhaitez peut-être configurer une application ASP.NET pour utiliser une version antérieure. Les sections suivantes décrivent le processus pour configurer une application ASP.NET afin de cibler une version spécifique du .NET Framework.
Visualisation du scriptmap pour une application ASP.NET
Lors de la gestion d'un ordinateur contenant plusieurs versions du .NET Framework installées, il est souvent utile de visualiser le scriptmap pour une application ASP.NET afin de déterminer la version utilisée par l'application. Vous pouvez visualiser le scriptmap pour une application ASP.NET à l'aide de la console de gestion IIS.
Pour visualiser le scriptmap pour une application ASP.NET
Ouvrez la console de gestion IIS, développez l'ordinateur local en cliquant sur le signe plus et accédez au dossier qui contient l'application ASP.NET.
Cliquez avec le bouton droit sur la table et cliquez sur Propriétés. La boîte de dialogue Propriétés s'affiche.
Sous l'onglet Général, cliquez sur le bouton Accessibilité. La boîte de dialogue Configuration de l'application s'affiche.
Sous l'onglet Mappages, sélectionnez une extension d'application ASP.NET comme .asmx ou .aspx.
La colonne Chemin exécutable de la boîte de dialogue répertorie le chemin d'accès vers la version ISAPI ASP.NET utilisée par l'application. Par défaut, ISAPI ASP.NET est installé à l'emplacement suivant :
systemroot\Microsoft.NET\Framework\Numéroversion
Le numéro de version présent dans le chemin d'accès indique le numéro de version ISAPI ASP.NET utilisé par l'application. La version ISAPI ASP.NET détermine la version du runtime utilisée par l'application.
Mise à jour des scriptmaps à l'aide de Aspnet_regiis.exe
Pour faciliter la reconfiguration du scriptmap pour une application ASP.NET, chaque installation du .NET Framework est fournie avec une version associée de l'outil ASP.NET IIS Registration (Aspnet_regiis.exe). Les administrateurs peuvent utiliser cet outil pour remapper une application ASP.NET sur la version ISAPI ASP.NET associée à l'outil.
Remarque Comme l'outil Aspnet_regiis.exe est lié à une version spécifique du .NET Framework, les administrateurs doivent utiliser la version appropriée de Aspnet_regiis.exe pour reconfigurer le scriptmap pour une application ASP.NET. L'outil Aspnet_regiis.exe reconfigure uniquement le scriptmap d'une application ASP.NET sur la version ISAPI ASP.NET associée à l'outil.
L'outil peut également être utilisé pour afficher l'état de toutes les versions installées de ASP.NET, inscrire la version ASP.NET associée, créer des répertoires de scripts côté client et effectuer d'autres opérations de configuration.
Pour utiliser Aspnet_regiis.exe afin de mettre à jour un scriptmap pour une application ASP.NET
Ouvrez une fenêtre d'invite de commandes. (Cliquez sur Démarrer, puis sur Exécuter, tapez cmd, puis cliquez sur OK.)
Accédez au répertoire de la version de Aspnet_regiis.exe que vous souhaitez utiliser. N'oubliez pas que chaque version du .NET Framework est livrée avec sa propre version. Le fichier est généralement situé dans le répertoire suivant :
systemroot\Microsoft.NET\Framework\Numéroversion
Utilisez l'option -s ou -sn de Aspnet_regiis.exe avec le chemin d'accès vers l'application 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
Regroupement d'applications dans IIS 6.0
Les versions de IIS antérieures à la version 6.0 utilisent le modèle de processus ASP.NET (Aspnet_wp.exe). Sous le modèle de processus ASP.NET, chaque version d'application unique s'exécute automatiquement dans un processus séparé au moment de l'exécution. Toutes les applications qui ciblent la même version du runtime partagent le même processus (ou plusieurs processus en mode jardin Web). Cependant, IIS 6.0 utilise le modèle de processus IIS 6.0 (w3wp.exe) et introduit une nouvelle fonctionnalité d'isolation appelée le regroupement d'applications. Le regroupement d'applications permet à des applications de s'exécuter ensemble sous un ou plusieurs processus tant qu'elles partagent la même désignation de pool. Les applications auxquelles sont assignées différents pools d'applications ne s'exécutent jamais dans le même processus.
Lorsque des versions multiples du .NET Framework sont installées sur un ordinateur qui utilise IIS 6.0, vous pouvez rencontrer le message d'erreur suivant dans le journal des événements de l'application.
Il n'est pas possible d'exécuter différentes versions de ASP.NET dans le même processus IIS. Utilisez l'outil d'administration IIS pour reconfigurer votre serveur pour exécuter l'application dans un processus séparé.
Cette erreur se produit lorsque plus d'une version de ASP.NET est configurée pour s'exécuter dans le même processus. Différentes versions du .NET Framework et du runtime ne peuvent pas cohabiter en mode côte à côte dans le même processus. Par conséquent, une application ASP.NET qui utilise une version particulière du runtime ne doit pas partager de processus avec une application qui utilise une version différente. Cette erreur se produit généralement lorsque au moins deux applications sont mappées sur différentes versions de ASP.NET, mais partagent le même pool d'applications.
Pour utiliser le regroupement d'applications, veillez à ce que le mode isolation IIS 5.0 soit désactivé. Puis, accédez à l'application souhaitée dans la console de gestion IIS et assignez-lui un pool d'applications. Si vous voulez isoler votre application des pools d'applications existants, créez une nouvelle désignation de pool.
Remarque Le processus d'isolation pour chaque application est configuré manuellement.
Pour désactiver le mode isolation IIS 5.0 dans IIS 6.0
- Ouvrez la console de gestion IIS et développez l'ordinateur local en cliquant sur le signe plus.
- Cliquez avec le bouton droit sur le dossier Sites Web et cliquez sur Propriétés.
- Sous l'onglet Service, désactivez la case à cocher Exécuter les services Web en mode d'isolation IIS 5.0.
Pour assigner une désignation de pool à une application ASP.NET dans IIS 6.0
- Ouvrez la console de gestion IIS, développez l'ordinateur local en cliquant sur le signe plus et accédez au dossier qui contient l'application ASP.NET.
- Cliquez avec le bouton droit sur la file d'attente, puis cliquez sur Propriétés. La boîte de dialogue des propriétés de l'application s'affiche.
- Sous l'onglet Répertoire, sélectionnez la désignation de pool souhaitée dans la liste Pool d'applications.
Pour créer une désignation de pool dans IIS 6.0
- Ouvrez la console de gestion IIS et développez l'ordinateur local en cliquant sur le signe plus.
- Cliquez avec le bouton droit sur le dossier Pools d'applications, pointez sur Nouveau, puis cliquez sur Pool d'applications. La boîte de dialogue Ajouter un nouveau pool d'application s'affiche.
- Entrez la nouvelle désignation de pool dans la zone de texte ID du pool d'applications, puis cliquez sur OK.
Voir aussi
Prise en charge de l'exécution côte à côte dans ASP.NET | Vue d'ensemble de l'exécution côte à côte dans ASP.NET