Procédure pas à pas : configuration d'applications ASP.NET dans IIS 6.0 à l'aide de MMC

Article
10/22/2014

Mise à jour : novembre 2007

ASP.NET vous permet de définir des paramètres de configuration pour les applications qui s'exécutent dans les services IIS (Internet Information Services) 6.0. Vous pouvez définir ces paramètres de configuration de l'une des manières suivantes :

À l'aide de l'outil Administration de site Web qui permet d'autoriser les propriétaires de sites Web à gérer leurs sites localement ou à distance. Pour plus d'informations, consultez Outil Administration de site Web ASP.NET.
À l'aide de l'API de configuration qui vous permet de gérer les paramètres par programme. Pour plus d'informations, consultez Vue d'ensemble de l'API de configuration ASP.NET.
À l'aide de la console MMC (Microsoft Management Console) d'ASP.NET. MMC permet à un administrateur du serveur de définir des paramètres de configuration pour tous les sites Web ou pour un site Web spécifique. Contrairement à l'outil Administration de site Web, MMC vous permet de contrôler l'ensemble de la hiérarchie de configuration du serveur Web.

Dans cette procédure pas à pas, vous explorerez MMC. Vous ajouterez un paramètre d'application à un seul site Web qui stockera une valeur représentant la couleur d'arrière-plan d'une page Web. Vous créerez ensuite une page Web ASP.NET qui utilise le paramètre d'application que vous appliquez. Bien que la tâche que vous exécutez avec la console MMC dans cette procédure pas à pas soit simple, elle constitue une bonne introduction à l'utilisation de la console MMC d'ASP.NET.

Cette procédure pas à pas décrit notamment les tâches suivantes :

lancement de la console MMC d'ASP.NET ;
configuration des paramètres dans la console MMC ;
affichage des résultats des modifications de configuration apportées à l'aide de la console MMC.
Pour plus d'informations sur la configuration d'IIS à l'aide du Gestionnaire des services IIS, consultez Configuring Internet Sites and Services (IIS 6.0).

Remarque :
Lorsque vous utilisez le composant logiciel enfichable MMC d'IIS pour configurer un serveur distant, la boîte de dialogue Paramètres de configuration ASP.NET n'est pas disponible.

Composants requis

Pour exécuter cette procédure pas à pas, vous devrez :

avoir les services ISS (Internet Information Services) version 6.0 de Microsoft installés localement sur votre ordinateur ;
avoir la version 2.0 du .NET Framework ;
avoir les privilèges d'administrateur sur votre ordinateur.

Création d'un répertoire virtuel IIS

Dans la première partie de la procédure pas à pas, vous créerez un dossier pour vos pages Web et utiliserez le Gestionnaire des services IIS pour créer un répertoire virtuel sur lequel il pointe.

Pour créer un dossier et un répertoire virtuel IIS

Sur votre ordinateur, créez un dossier pour y stocker les fichiers de votre site Web.

Par exemple, créez un dossier nommé C:\SampleWebSite.
Cliquez sur Démarrer, puis sur Exécuter.
Dans la zone Ouvrir, tapez inetmgr, puis cliquez sur OK.
Dans Gestionnaire des services IIS, développez l'ordinateur local, puis développez Sites Web.
Cliquez avec le bouton droit sur Site Web par défaut, pointez sur Nouveau, puis cliquez sur Répertoire virtuel.

L'Assistant Création de répertoire virtuel apparaît.
Cliquez sur Suivant.
Dans la zone Alias, attribuez un nom au site, par exemple SampleWebSite, puis cliquez sur Suivant.
Dans la zone Chemin d'accès, entrez le chemin d'accès du dossier que vous avez créé à l'étape 1, puis cliquez sur Suivant.
Activez les cases à cocher Lire et Exécuter les scripts, cliquez sur Suivant, puis sur Terminer.

Utilisation de la console MMC d'ASP.NET pour définir les paramètres d'application

Vous pouvez maintenant utiliser la console MMC d'ASP.NET pour définir les paramètres du site Web.

Pour créer le paramètre d'application

Dans le Gestionnaire des services IIS, cliquez avec le bouton droit sur le nom de votre nouveau répertoire virtuel, puis cliquez sur Propriétés.

La boîte de dialogue Propriétés de <NomSiteWeb> s'affiche.
Dans l'onglet ASP.NET, cliquez sur Modifier la configuration.

La boîte de dialogue Paramètres de configuration ASP.NET s'affiche.
Dans l'onglet Général, sous Paramètres de l'application, cliquez sur Ajouter.

La boîte de dialogue Modifier/ajouter des paramètres d'application s'affiche.
Dans la zone Clé, tapez CustomBGColor.
Dans la zone Valeur, tapez #00FF00, qui est le code de couleur hexadécimal du vert.
Cliquez sur OK pour fermer la boîte de dialogue Modifier/ajouter des paramètres d'application.
Cliquez sur OK pour fermer la boîte de dialogue Paramètres de configuration ASP.NET.
Cliquez sur OK pour fermer la boîte de dialogue Propriétés de <NomSiteWeb>.

Remarque :

Laissez le Gestionnaire des services IIS ouvert.

Remarque :
Laissez le Gestionnaire des services IIS ouvert.

La console MMC d'ASP.NET est un outil graphique destiné à la modification des fichiers de configuration ASP.NET. Dans cette procédure pas à pas, vous modifiez les paramètres de configuration d'une seule application Web, ce qui signifie que vous modifiez le fichier Web.config du site Web créé au début de la procédure. Vous devez à présent vérifier le paramètre que vous avez défini dans la console MMC d'ASP.NET en examinant le fichier Web.config.

Pour vérifier le paramètre d'application

Dans l'Explorateur Windows, accédez au dossier que vous avez créé au début de la procédure.

Le dossier contient désormais un fichier Web.config. Lorsque vous avez créé les paramètres de configuration du site Web, MMC a créé un nouveau fichier Web.config parce qu'il n'en existait pas auparavant.
Ouvrez le fichier Web.config spécifié dans un éditeur de texte, tel que Bloc-notes.
Vérifiez que l'élément suivant a été créé dans le fichier Web.config :
```
<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <appSettings>
        <add key="CustomBGColor" value="#00ff00" />
    </appSettings>
</configuration>
```
MMC a créé l'élément <appSettings> pour contenir la paire clé/valeur que vous avez définie.

Utilisation du paramètre d'application

Vous pouvez désormais tester le paramètre d'application que vous avez créé à l'aide de MMC en créant une page Web qui utilise le paramètre.

Pour utiliser le paramètre d'application

Dans le dossier que vous avez créé au début de la procédure, créez un fichier texte et nommez-le Default.aspx.

Vous pouvez modifier le fichier à l'aide d'un éditeur de texte, tel que Bloc-notes.

Copiez le code suivant dans la page Default.aspx :

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script >
    Protected Function CustomBGColor() As String
        Return ConfigurationManager.AppSettings("CustomBGColor")
    End Function
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>Sample Web Application</title>
</head>
<body style="background-color:<%=CustomBGColor%>">
<form  id="Form1">
    Body background color:
    <%=CustomBGColor%>
</form>    
</body>
</html>

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script >
    string CustomBGColor =
         ConfigurationManager.AppSettings["CustomBGColor"];
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
    <title>Sample Web Application</title>
</head>
<body style="background-color:<%=CustomBGColor%>">
<form  id="Form1">
    Body background color:
    <%=CustomBGColor%>
</form>    
</body>
</html>

Ouvrez le navigateur, puis entrez l'URL suivante :
```
https://localhost/SampleWebSite/Default.aspx
```
La page s'affiche dans le navigateur.
Vérifiez que la couleur d'arrière-plan est verte.

Modification des paramètres dans la console MMC d'ASP.NET

Vous pouvez également utiliser la console MMC d'ASP.NET pour modifier des paramètres existants.

Pour modifier la couleur d'arrière-plan

Dans le Gestionnaire des services IIS, cliquez avec le bouton droit sur le répertoire virtuel, puis cliquez sur Propriétés.
Dans l'onglet ASP.NET, cliquez sur Modifier la configuration.
Dans l'onglet Général, sous Paramètres de l'application, cliquez sur la ligne qui contient le paramètre CustomBGColor, puis cliquez sur Modifier.
Dans la zone Valeur, tapez #0000FF (le code de couleur hexadécimal de la couleur bleue).
Cliquez sur OK pour fermer la boîte de dialogue Modifier/ajouter des paramètres d'application.
Cliquez sur OK pour fermer la boîte de dialogue Paramètres de configuration ASP.NET.
Cliquez sur OK pour fermer la boîte de dialogue Propriétés de <NomSiteWeb>.
Ouvrez le navigateur, puis entrez l'URL suivante :
```
https://localhost/SampleWebSite/Default.aspx
```
Vérifiez que la couleur d'arrière-plan est bleue.

Étapes suivantes

Cette procédure pas à pas vous a fourni une introduction à la console MMC d'ASP.NET, qui vous permet de définir des paramètres de configuration ASP.NET en tant qu'administrateur sur l'ordinateur serveur Web. Vous pouvez également explorer d'autres solutions pour utiliser les paramètres de configuration ASP.NET. Voici quelques suggestions pour une exploration plus approfondie :

Utilisez l'outil Administration de site Web pour appliquer les paramètres de configuration d'un site Web unique. Pour plus d'informations, consultez Outil Administration de site Web ASP.NET.
Utilisez les API de configuration pour modifier les paramètres de configuration par programme. Pour plus d'informations, consultez API de configuration ASP.NET.