Bagikan melalui

Menambahkan elemen Add> Modul <untuk Layanan Informasi Internet (IIS) 7;

Gambaran Umum

Elemen <add> <modules> koleksi menambahkan modul ke daftar modul untuk Layanan Informasi Internet (IIS) 7.

Kompatibilitas

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

Siapkan

Elemen <add> <modules> koleksi disertakan dalam penginstalan default IIS 7.

Bagaimana Caranya

Cara menambahkan modul terkelola ke aplikasi

  1. Buka Manajer Layanan Informasi Internet (IIS):

    • Jika Anda menggunakan Windows Server 2012 atau Windows Server 2012 R2:

      • Pada bilah tugas, klik Manajer Server, klik Alat, lalu klik manajer Layanan Informasi Internet (IIS).

    • Jika Anda menggunakan Windows 8 atau Windows 8.1:

      • Tahan tombol Windows, tekan huruf X, lalu klik Panel Kontrol.
      • Klik Alat Administratif, lalu klik dua kali manajer Layanan Informasi Internet (IIS).

    • Jika Anda menggunakan Windows Server 2008 atau Windows Server 2008 R2:

      • Pada bilah tugas, klik Mulai, arahkan ke Alat Administratif, lalu klik manajer Layanan Informasi Internet (IIS).

    • Jika Anda menggunakan Windows Vista atau Windows 7:

      • Pada bilah tugas, klik Mulai, lalu klik Panel Kontrol.
      • Klik dua kali Alat Administratif, lalu klik dua kali Layanan Informasi Internet (IIS) Manager.

  2. Di panel Koneksi ions, perluas nama server, perluas Situs, lalu buka situs Web atau aplikasi tempat Anda ingin menambahkan modul terkelola.

  3. Di panel Beranda , klik dua kali Modul.
    Cuplikan layar panel Beranda yang menampilkan Modul disorot.

  4. Di panel Tindakan, klik Tambahkan Modul Terkelola.

  5. Dalam kotak dialog Tambahkan Modul Terkelola, masukkan nama modul terkelola dalam kotak Nama , lalu masukkan atau pilih jenis .NET Framework modul yang sepenuhnya memenuhi syarat dalam kotak Jenis.

  6. Pilih opsi Panggil hanya untuk permintaan ASP.NET aplikasi atau handler terkelola jika Anda ingin modul hanya merespons permintaan terkelola.
    Gambar dialog Tambahkan Modul Terkelola memperlihatkan kotak Nama dan Jenis dengan Panggil hanya untuk permintaan ke aplikasi A S P dot Net atau opsi handler terkelola.

  7. Klik OK.

Konfigurasi

Atribut

Atribut Deskripsi
name Atribut string yang diperlukan.

Menentukan nama unik modul terkelola di server Web.
preCondition Atribut string opsional. Menentukan kondisi di mana modul akan berjalan.

Atribut preCondition dapat berupa satu atau beberapa nilai yang mungkin berikut ini. Jika Anda menentukan lebih dari satu nilai, pisahkan nilai dengan koma (,).

Nilai Deskripsi
bitness32 Tentukan nilai bitness32 saat modul adalah file .dll 32-bit. IIS harus memuat handler hanya untuk proses pekerja yang berjalan dalam mode WOW64 (simulasi 32-bit) pada sistem operasi 64-bit.
bitness64 Tentukan nilai bitness64 saat modul adalah file .dll 64-bit. IIS harus memuat handler hanya untuk proses pekerja yang berjalan dalam mode 64-bit.
integratedMode Tentukan nilai integratedMode ketika modul harus merespons hanya permintaan di kumpulan aplikasi yang dikonfigurasi untuk menggunakan alur pemrosesan permintaan terintegrasi.
ISAPIMode Tentukan nilai ISAPIMode ketika modul harus merespons hanya permintaan dalam kumpulan aplikasi yang dikonfigurasi untuk menggunakan mode Klasik.
managedHandler Tentukan nilai managedHandler ketika modul harus memproses permintaan hanya untuk sumber daya terkelola, seperti file .aspx, dan tidak boleh menanggapi permintaan sumber daya yang tidak dikelola, seperti file .html.
runtimeVersionv1.1 Tentukan nilai runtimeVersionv1.1 ketika modul harus merespons hanya permintaan di kumpulan aplikasi yang dikonfigurasi untuk menggunakan .NET Framework versi 1.1.
runtimeVersionv2.0 Tentukan nilai runtimeVersionv2.0 ketika modul harus merespons hanya permintaan di kumpulan aplikasi yang dikonfigurasi untuk menggunakan .NET Framework versi 2.0.
runtimeVersionv4.0 Tentukan nilai runtimeVersionv4.0 ketika modul harus merespons hanya permintaan di kumpulan aplikasi yang dikonfigurasi untuk menggunakan .NET Framework versi 4.0.
type Atribut string opsional.

Menentukan jenis terkelola modul terkelola. Atribut jenis tidak berlaku untuk modul asli.

Elemen Anak

Tidak ada.

Sampel Konfigurasi

Contoh mengonfigurasi modul untuk aplikasi Web yang berjalan dalam mode Terintegrasi IIS 7.

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

Kode Sampel

Catatan

Contoh dalam dokumen ini menggambarkan menggunakan rakitan kode terkelola yang telah disimpan di .NET Global Assembly Cache (GAC). Sebelum menggunakan kode dalam contoh ini untuk menyebarkan rakitan Anda sendiri, Anda perlu mengambil informasi perakitan dari GAC. Untuk melakukannya, gunakan langkah-langkah berikut:

  • Di Windows Explorer, buka jalur C:\Windows\assembly Anda, di mana C: adalah drive sistem operasi Anda.
  • Temukan assembly Anda.
  • Klik kanan rakitan dan klik Properti.
  • Salin nilai Budaya; misalnya: Netral.
  • Salin Nomor versi; misalnya: 1.0.0.0.
  • Salin nilai Token Kunci Publik; misalnya: 426f62526f636b73.
  • Klik Batalkan.

Contoh kode berikut mengaktifkan modul terkelola untuk situs Web bernama Contoso. Properti nama menentukan nama CartHeader untuk modul, properti jenis menentukan jenis terkelola untuk modul, properti preCondition menentukan bahwa IIS memanggil modul hanya untuk permintaan terkelola.

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()
  • Last updated on