Ajout d’un élément Modules <pour Internet Information Services (IIS) 7 ;

Vue d’ensemble

L’élément <add> de la collection <modules> ajoute un module à la liste des modules pour Internet Information Services (IIS) 7.

Compatibilité

Programme d’installation

L’élément <add> de la collection <modules> est inclus dans l’installation par défaut d’IIS 7.

Procédure

Comment ajouter un module managé à une application

1. Ouvrez le Gestionnaire Internet Information Services (IIS) :

   • Si vous utilisez Windows Server 2012 ou Windows Server 2012 R2 :

     • Dans la barre des tâches, cliquez sur Gestionnaire de serveur, cliquez sur Outils, puis sur Gestionnaire Internet Information Services (IIS).

   • Si vous utilisez Windows 8 ou Windows 8.1 :

     • Maintenez la touche Windows enfoncée, appuyez sur la lettre X, puis cliquez sur Panneau de configuration.
     • Cliquez sur Outils d’administration, puis double-cliquez sur Gestionnaire Internet Information Services (IIS).

   • Si vous utilisez Windows Server 2008 ou Windows Server 2008 R2 :

     • Cliquez sur Démarrer, placez le curseur sur Outils d’administration, puis cliquez sur Gestionnaire Internet Information Services (IIS).

   • Si vous utilisez Windows Vista ou Windows 7 :

     • Dans la barre des tâches, cliquez sur Démarrer, puis sur Panneau de configuration.
     • Double-cliquez sur Outils d’administration, puis sur Gestionnaire Internet Information Services (IIS).

2. Dans le volet Connexions, développez le nom du serveur, Sites, puis accédez au site web ou à l’application auquel vous souhaitez ajouter un module managé.

3. Dans le volet Accueil, double-cliquez sur Modules.
   

4. Dans le volet Actions, cliquez sur Ajouter un module managé.

5. Dans la boîte de dialogue Ajouter un module managé, entrez le nom du module managé dans la zone Nom, puis entrez ou sélectionnez le type complet .NET Framework du module dans la zone Type.

6. Sélectionnez l’option Appeler uniquement pour les requêtes adressées aux applications ASP.NET ou aux gestionnaires managés si vous souhaitez que le module réponde uniquement aux requêtes managées.
   

7. Cliquez sur OK.

Configuration

Attributs

Éléments enfants

Aucune.

Exemple Configuration

L’exemple configure un module pour une application web s’exécutant en mode intégré IIS 7.

<configuration>
   <system.webServer>
      <modules>
         <add name="Header" type="Contoso.ShoppingCart.Header"/>
      </modules>
   </system.webServer>
</configuration>

Exemple de code

• Dans l’Explorateur Windows, ouvrez votre chemin C:\Windows\assembly, où C: est votre lecteur de système d’exploitation.
• Recherchez votre assembly.
• Cliquez avec le bouton droit sur l’assembly et cliquez sur Propriétés.
• Copiez la valeur Culture, par exemple Neutre.
• Copiez le numéro de version, par exemple 1.0.0.0.
• Copiez la valeur du jeton de clé publique, par exemple 426f62526f636b73.
• Cliquez sur Annuler.

Les exemples de code suivants activent un module managé pour un site web nommé Contoso. La propriété name définit le nom CartHeader pour le module, la propriété type définit le type managé pour le module, la propriété preCondition définit qu’IIS appelle le module uniquement pour les requêtes managées.

AppCmd.exe

appcmd.exe set config "Contoso" -section:system.webServer/modules /+"[name='CartHeader',type='Contoso.ShoppingCart.Header',preCondition='managedHandler']"

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetWebConfiguration("Contoso");
         ConfigurationSection modulesSection = config.GetSection("system.webServer/modules");
         ConfigurationElementCollection modulesCollection = modulesSection.GetCollection();

         ConfigurationElement addElement = modulesCollection.CreateElement("add");
         addElement["name"] = @"CartHeader";
         addElement["type"] = @"Contoso.ShoppingCart.Header";
         addElement["preCondition"] = @"managedHandler";
         modulesCollection.Add(addElement);

         serverManager.CommitChanges();
      }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample
   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetWebConfiguration("Contoso")
      Dim modulesSection As ConfigurationSection = config.GetSection("system.webServer/modules")
      Dim modulesCollection As ConfigurationElementCollection = modulesSection.GetCollection

      Dim addElement As ConfigurationElement = modulesCollection.CreateElement("add")
      addElement("name") = "CartHeader"
      addElement("type") = "Contoso.ShoppingCart.Header"
      addElement("preCondition") = "managedHandler"
      modulesCollection.Add(addElement)

      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST/Contoso";
var modulesSection = adminManager.GetAdminSection("system.webServer/modules", "MACHINE/WEBROOT/APPHOST/Contoso");
var modulesCollection = modulesSection.Collection;

var addElement = modulesCollection.CreateNewElement("add");
addElement.Properties.Item("name").Value = "CartHeader";
addElement.Properties.Item("type").Value = "Contoso.ShoppingCart.Header";
addElement.Properties.Item("preCondition").Value = "managedHandler";
modulesCollection.AddElement(addElement);

adminManager.CommitChanges();

VBScript

Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST/Contoso"
Set modulesSection = adminManager.GetAdminSection("system.webServer/modules", "MACHINE/WEBROOT/APPHOST/Contoso")
Set modulesCollection = modulesSection.Collection

Set addElement = modulesCollection.CreateNewElement("add")
addElement.Properties.Item("name").Value = "CartHeader"
addElement.Properties.Item("type").Value = "Contoso.ShoppingCart.Header"
addElement.Properties.Item("preCondition").Value = "managedHandler"
modulesCollection.AddElement addElement

adminManager.CommitChanges()