Elemento Modules Element <modules>

Panoramica

L'elemento <modules> definisce i moduli di codice nativo e i moduli di codice gestito registrati per un'applicazione. Come parte dell'elaborazione della pipeline di richiesta di Internet Information Services (IIS), IIS chiama ogni modulo elencato nell'elemento <modules> in ogni richiesta. In genere si usano moduli per implementare funzionalità personalizzate, ad esempio sicurezza, statistiche e registrazione o elaborazione di contenuti personalizzati, ad esempio l'aggiunta di intestazioni o piè di pagina personalizzati.

L'elemento <modules> contiene una raccolta di <add> elementi. Ogni elemento definisce un modulo abilitato per l'applicazione. Quando si abilita un modulo, si consente di fornire il relativo servizio per una determinata applicazione.

Se si vuole abilitare un modulo nativo, è prima necessario installarlo nel server. Per altre informazioni, vedere l'elemento <globalModules> .

Non è necessario installare un modulo gestito; è possibile abilitarla direttamente per ogni applicazione. Ciò consente alle applicazioni di includere i moduli gestiti direttamente all'interno dell'applicazione registrandoli nel file Web.config dell'applicazione e fornendo l'implementazione nelle directory /BIN o /App_Code.

Compatibilità

Installazione

L'elemento <modules> è incluso nell'installazione predefinita di IIS 7.

Procedure

Come aggiungere un modulo gestito all'applicazione

1. Aprire Gestione Internet Information Services (IIS):

   • Se si usa Windows Server 2012 o Windows Server 2012 R2:

     • Sulla barra delle applicazioni fare clic su Server Manager, scegliere Strumenti, quindi fare clic su Gestione Internet Information Services (IIS).

   • Se si usa Windows 8 o Windows 8.1:

     • Tenere premuto il tasto Windows, premere la lettera X e quindi fare clic su Pannello di controllo.
     • Fare clic su Strumenti di amministrazione, quindi fare doppio clic su Gestione Internet Information Services (IIS).

   • Se si usa Windows Server 2008 o Windows Server 2008 R2:

     • Sulla barra delle applicazioni fare clic su Start, scegliere Strumenti di amministrazione, quindi fare clic su Gestione Internet Information Services (IIS).

   • Se si usa Windows Vista o Windows 7:

     • Sulla barra delle applicazioni fare clic su Start e quindi su Pannello di controllo.
     • Fare doppio clic su Strumenti di amministrazione, quindi fare doppio clic su Gestione Internet Information Services (IIS).

2. Nel riquadro Connessioni espandere il nome del server, espandere Siti e quindi passare al sito Web o all'applicazione a cui si vuole aggiungere un modulo gestito.

3. Nel riquadro Home fare doppio clic su Moduli.
   

4. Nel riquadro Azioni fare clic su Aggiungi modulo gestito.

5. Nella finestra di dialogo Aggiungi modulo gestito immettere il nome del modulo gestito nella casella Nome e quindi immettere o selezionare il tipo completo di .NET Framework del modulo nella casella Tipo.

6. Selezionare l'opzione Invoke only for requests to ASP.NET applications or managed handlers (Richiama solo per le richieste a ASP.NET applicazioni o gestori gestiti ) se si vuole che il modulo risponda solo alle richieste gestite.
   

7. Fare clic su OK.

Configurazione

L'elemento <modules> viene configurato a livello di server nel file ApplicationHost.config e a livello di applicazione nel file Web.config.

Attributi

Elementi figlio

Esempio di configurazione

Nell'esempio viene configurato un modulo per un'applicazione Web in esecuzione in modalità integrata IIS 7.

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

Codice di esempio

• In Esplora risorse aprire il percorso C:\Windows\assembly, dove C: è l'unità del sistema operativo.
• Individuare l'assembly.
• Fare clic con il pulsante destro del mouse sull'assembly e scegliere Proprietà.
• Copiare il valore Culture ; ad esempio : neutrale.
• Copiare il numero di versione ; ad esempio : 1.0.0.0.
• Copiare il valore del token di chiave pubblica ; ad esempio : 426f62526f636b73.
• Fare clic su Annulla.

Gli esempi di codice seguenti abilitano un modulo gestito per un sito Web denominato Contoso. La proprietà name definisce il nome CartHeader per il modulo, la proprietà type definisce il tipo gestito per il modulo, la proprietà preCondition definisce che IIS richiama il modulo solo per le richieste gestite.

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()