Listener Adapter <ListenerAdapters>

Gambaran Umum

Elemen <listenerAdapters> menentukan pengaturan konfigurasi untuk adaptor pendengar untuk Internet Information Services (IIS) 7. Adaptor pendengar adalah komponen yang membangun komunikasi antara layanan pendengar protokol non-HTTP dan Layanan Aktivasi Proses Windows (WAS). Perubahan pada <listenerAdapters> elemen hanya berlaku saat adaptor pendengar terhubung dengan WAS. Dalam kebanyakan kasus, koneksi ini mengharuskan server dimulai ulang.

Catatan:

• World Wide Web Publishing Service (W3SVC) berisi fungsionalitas khusus HTTP untuk IIS 7, sehingga tidak menggunakan atribut tambahan <listenerAdapters> . - Layanan FTP, yang tidak memerlukan WAS, tidak memiliki <listenerAdapters> entri.

Kompatibilitas

Versi	Catatan
IIS 10.0	Elemen <listenerAdapters> tidak dimodifikasi dalam IIS 10.0.
IIS 8.5	Elemen <listenerAdapters> tidak dimodifikasi dalam IIS 8.5.
IIS 8.0	Elemen <listenerAdapters> tidak dimodifikasi dalam IIS 8.0.
IIS 7.5	Elemen <listenerAdapters> tidak dimodifikasi dalam IIS 7.5.
IIS 7.0	Elemen ini <listenerAdapters> diperkenalkan di IIS 7.0.
IIS 6.0	T/A

Siapkan

Elemen <listenerAdapters> ini disertakan dalam penginstalan default IIS 7.

Bagaimana Caranya

Tidak ada antarmuka pengguna untuk menambahkan adaptor pendengar untuk IIS 7. Untuk contoh cara menambahkan adaptor pendengar secara terprogram, lihat bagian Sampel Kode dari dokumen ini.

Konfigurasi

Atribut

Tidak ada.

Elemen Anak

Elemen	Deskripsi
add	Elemen opsional. Menentukan konfigurasi untuk adaptor pendengar.

Sampel Konfigurasi

Sampel konfigurasi berikut menambahkan adaptor pendengar untuk penyedia protokol Gopher, dan menentukan nama DLL dan fungsi inisialisasinya.

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

Kode Sampel

Sampel kode berikut menambahkan adaptor pendengar untuk penyedia protokol Gopher, dan menentukan nama DLL dan fungsi inisialisasinya.

AppCmd.exe

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

Catatan

Anda harus memastikan untuk mengatur parameter penerapan ke apphost saat Anda menggunakan AppCmd.exe untuk mengonfigurasi pengaturan ini. Ini menerapkan pengaturan konfigurasi ke bagian lokasi yang sesuai dalam 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()