Procedura: configurare un'estensione del gestore HTTP in IIS
Aggiornamento: novembre 2007
Per impostazione predefinita, Internet Information Services (IIS) passa ad ASP.NET solo le richieste per determinati tipi di file ai fini dell'elaborazione. Per i file con estensioni quali ASPX, ASMX e ASHX è già stato eseguito il mapping all'estensione ISAPI ASP.NET (Aspnet_isapi.dll). Questo vale per IIS 6.0, IIS 7.0 eseguito in modalità classica e per gestori gestiti in IIS 7.0 in esecuzione in modalità integrata.
Per fare in modo che IIS passi altre estensioni di file ad ASP.NET, è necessario registrare tali estensioni in IIS. Per ulteriori informazioni sulla partecipazione dei gestori nel ciclo di vita delle applicazioni, vedere Cenni preliminari sul ciclo di vita delle applicazioni ASP.NET per IIS 5.0 e 6.0 o Cenni preliminari sul ciclo di vita delle applicazioni ASP.NET per IIS 7.0.
Per eseguire il mapping di un'estensione di file in IIS 6.0
Aprire Gestione IIS.
Espandere il nodo del computer server Web, quindi espandere Siti Web e infine Sito Web predefinito.
Fare clic con il pulsante destro del mouse sull'applicazione, quindi scegliere Proprietà.
.gif "Nota")
Nota:Per informazioni sulla creazione di un'applicazione ASP.NET, vedere Procedura: creare e configurare siti Web ASP.NET locali in IIS 6.0.
Selezionare la scheda Directory virtuale, quindi fare clic su Configurazione.
Nella scheda Mapping fare clic su Aggiungi.
Verrà visualizzata la finestra di dialogo Aggiunta/Modifica mapping estensioni applicazioni.
Nella casella Eseguibile digitare o selezionare il file Aspnet_isapi.dll. Per impostazione predefinita, il file si trova nel percorso seguente:
%windows%\Microsoft.NET\Framework\version\Nota:È possibile ottenere il nome del file e il percorso completo da altri mapping, ad esempio quello ai file ASPX.
Nella casella Estensione, digitare l'estensione di file, ad esempio .sample.
Nota:Assicurarsi di inserire il punto (.) come parte dell'estensione.
Selezionare la casella di controllo Verifica esistenza del file in base a ciò che l'estensione di file rappresenta nell'applicazione. Scegliere una delle opzioni seguenti:
True. L'estensione di file rappresenta un file fisico nell'applicazione. In questo caso, se il file richiesto non esiste sul disco, IIS visualizza un errore.
False. L'estensione di file non rappresenta un file fisico. Al contrario, viene gestita in modo dinamico da una classe mappata all'estensione stessa in ASP.NET.
Scegliere OK e chiudere Gestione IIS.
Per eseguire il mapping di un'estensione di file in IIS 7.0 eseguito in modalità classica
Aprire Gestione IIS.
Nota:In e Windows Server 2008, se la funzionalità Controllo dell'account utente è attivata, viene richiesto di proseguire con l'accesso. Per ulteriori informazioni, vedere User Account Control Overview (informazioni in lingua inglese).
Espandere il nodo del computer server Web, quindi espandere Siti e infine Sito Web predefinito.
Selezionare il nodo dell'applicazione.
Verrà visualizzato il riquadro Visualizzazione funzionalità.
In Visualizzazione funzionalità, fare doppio clic su Mapping gestori.
Nel riquadro Azioni, fare clic su Aggiungi mapping di script.
Verrà visualizzata la finestra di dialogo Aggiungi mapping di script.
Nella finestra di dialogo Aggiungi mapping di script, specificare le seguenti informazioni:
Percorso richiesta. Nome o estensione di file di cui eseguire il mapping.
Eseguibile. Percorso del file EXE o DLL che gestirà la richiesta. Nel caso della modalità classica, specificare l'estensione ISAPI ASP.NET (Aspnet_isapi.dll).
Nome. Un nome descrittivo.
Scegliere OK per chiudere la finestra di dialogo Aggiungi mapping di script.
Nota:L'utilizzo di Gestione IIS in IIS 7.0 per aggiungere un'estensione del gestore personalizzato equivale alla registrazione dell'estensione del gestore nel file Web.config di un'applicazione ASP.NET. La registrazione consente di aggiungere un elemento handler nella sezione handlers del gruppo system.webServer.
Aprire il file Web.config dell'applicazione.
Individuare l'elemento httpHandlers della sezione system.web e aggiungere una voce per l'estensione di file.
Nota:L'estensione di file deve essere registrata sia nell'elemento httpHandlers che nell'elemento handlers.
Per eseguire il mapping di un'estensione di file in IIS 7.0 eseguito in modalità integrata
Seguire i passaggi da 1 a 3 della procedura descritta in precedenza.
Nel riquadro Azioni, scegliere Aggiungi gestore gestito.
Verrà visualizzata la finestra di dialogo Aggiungi gestore gestito.
Nella finestra di dialogo Aggiungi gestore gestito, specificare le seguenti informazioni:
Percorso richiesta. Nome del file o estensione di file di cui eseguire il mapping.
Tipo. Nome del tipo (classe) del gestore gestito. Se il gestore è definito nella cartella App_Code dell'applicazione ASP.NET, il nome del tipo verrà visualizzato nell'elenco a discesa.
Nome. Un nome descrittivo.
Scegliere OK per chiudere la finestra di dialogo Aggiungi gestore gestito.
Nota:L'utilizzo di Gestione IIS in IIS 7.0 per aggiungere un'estensione del gestore personalizzato equivale alla registrazione dell'estensione del gestore nel file Web.config.
Nota:Un gestore che elabora un'estensione personalizzata in IIS 7.0 eseguito in modalità integrata richiede unicamente la registrazione nell'elemento handlers. Per mantenere la registrazione anche nell'elemento httpHandlers, creare un elemento validation nella sezione system.webServer, se non ne esiste già uno, e impostarne l'attributo validateIntegratedModeConfiguration su false. Per ulteriori informazioni, vedere Procedura: eliminare gli avvisi di registrazione di IIS 7.0,