Listener Adapters <ListenerAdapters>

Panoramica

L'elemento <listenerAdapters> specifica le impostazioni di configurazione per gli adattatori listener per Internet Information Services (IIS) 7. Gli adattatori listener sono componenti che stabiliscono la comunicazione tra i servizi listener del protocollo non HTTP e il servizio di attivazione dei processi di Windows (WAS). Le modifiche apportate all'elemento <listenerAdapters> diventano effettive solo quando un adattatore listener si connette a WAS. Nella maggior parte dei casi, questa connessione richiede il riavvio del server.

Note:

• W3SVC (World Wide Web Publishing Service) contiene funzionalità specifiche di HTTP per IIS 7, pertanto non utilizza attributi aggiuntivi <listenerAdapters> . - Il servizio FTP, che non richiede WAS, non ha una <listenerAdapters> voce.

Compatibilità

Versione	Note
IIS 10.0	L'elemento <listenerAdapters> non è stato modificato in IIS 10.0.
IIS 8,5	L'elemento <listenerAdapters> non è stato modificato in IIS 8.5.
IIS 8,0	L'elemento <listenerAdapters> non è stato modificato in IIS 8.0.
IIS 7,5	L'elemento <listenerAdapters> non è stato modificato in IIS 7.5.
IIS 7.0	L'elemento <listenerAdapters> è stato introdotto in IIS 7.0.
IIS 6.0	N/D

Installazione

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

Procedure

Non è disponibile alcuna interfaccia utente per l'aggiunta di adattatori listener per IIS 7. Per esempi di come aggiungere adattatori listener a livello di codice, vedere la sezione Esempi di codice di questo documento.

Configurazione

Attributi

Nessuno.

Elementi figlio

Elemento	Descrizione
add	Elemento facoltativo. Specifica la configurazione per un adattatore listener.

Esempio di configurazione

Nell'esempio di configurazione seguente viene aggiunto un adattatore listener per un provider di protocollo Gopher e viene specificato sia il nome della DLL che la relativa funzione di inizializzazione.

<system.applicationHost>
   <listenerAdapters>
      <add name="gopher"
         protocolManagerDll="%SystemRoot%\system32\inetsrv\gophersvc.dll"
         protocolManagerDllInitFunction="GopherInit" />
   </listenerAdapters>
</system.applicationHost>

Codice di esempio

Gli esempi di codice seguenti aggiungono un adattatore listener per un provider di protocolli Gopher e specificano sia il nome della DLL che la relativa funzione di inizializzazione.

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/listenerAdapters /+"[name='gopher',protocolManagerDll='%SystemRoot%\system32\inetsrv\gophersvc.dll',protocolManagerDllInitFunction='GopherInit']" /commit:apphost

Nota

È necessario assicurarsi di impostare il parametro commit su apphost quando si usa AppCmd.exe per configurare queste impostazioni. In questo modo le impostazioni di configurazione vengono confermate nella sezione relativa al percorso appropriato nel file ApplicationHost.config.

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.GetApplicationHostConfiguration();
         ConfigurationSection listenerAdaptersSection = config.GetSection("system.applicationHost/listenerAdapters");
         ConfigurationElementCollection listenerAdaptersCollection = listenerAdaptersSection.GetCollection();

         ConfigurationElement addElement = listenerAdaptersCollection.CreateElement("add");
         addElement["name"] = @"gopher";
         addElement["protocolManagerDll"] = @"%SystemRoot%\system32\inetsrv\gophersvc.dll";
         addElement["protocolManagerDllInitFunction"] = @"GopherInit";
         listenerAdaptersCollection.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.GetApplicationHostConfiguration
      Dim listenerAdaptersSection As ConfigurationSection = config.GetSection("system.applicationHost/listenerAdapters")
      Dim listenerAdaptersCollection As ConfigurationElementCollection = listenerAdaptersSection.GetCollection

      Dim addElement As ConfigurationElement = listenerAdaptersCollection.CreateElement("add")
      addElement("name") = "gopher"
      addElement("protocolManagerDll") = "%SystemRoot%\system32\inetsrv\gophersvc.dll"
      addElement("protocolManagerDllInitFunction") = "GopherInit"
      listenerAdaptersCollection.Add(addElement)

      serverManager.CommitChanges()
   End Sub

End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var listenerAdaptersSection = adminManager.GetAdminSection("system.applicationHost/listenerAdapters", "MACHINE/WEBROOT/APPHOST");
var listenerAdaptersCollection = listenerAdaptersSection.Collection;

var addElement = listenerAdaptersCollection.CreateNewElement("add");
addElement.Properties.Item("name").Value = "gopher";
addElement.Properties.Item("protocolManagerDll").Value = "%SystemRoot%\\system32\\inetsrv\\gophersvc.dll";
addElement.Properties.Item("protocolManagerDllInitFunction").Value = "GopherInit";
listenerAdaptersCollection.AddElement(addElement);

adminManager.CommitChanges();

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set listenerAdaptersSection = adminManager.GetAdminSection("system.applicationHost/listenerAdapters", "MACHINE/WEBROOT/APPHOST")
Set listenerAdaptersCollection = listenerAdaptersSection.Collection

Set addElement = listenerAdaptersCollection.CreateNewElement("add")
addElement.Properties.Item("name").Value = "gopher"
addElement.Properties.Item("protocolManagerDll").Value = "%SystemRoot%\system32\inetsrv\gophersvc.dll"
addElement.Properties.Item("protocolManagerDllInitFunction").Value = "GopherInit"
listenerAdaptersCollection.AddElement(addElement)

adminManager.CommitChanges()