Bagikan melalui

Filter <filter>

  • Artikel

Gambaran Umum

Elemen <filter><isapiFilters> koleksi mengonfigurasi filter ISAPI untuk memproses data permintaan klien atau data respons server.

Kompatibilitas

Versi Catatan
IIS 10.0 Elemen <filter> tidak dimodifikasi dalam IIS 10.0.
IIS 8.5 Elemen <filter> tidak dimodifikasi dalam IIS 8.5.
IIS 8.0 Elemen <filter> tidak dimodifikasi dalam IIS 8.0.
IIS 7.5 Elemen <filter> tidak dimodifikasi dalam IIS 7.5.
IIS 7.0 Elemen <filter><isapiFilters> koleksi diperkenalkan di IIS 7.0.
IIS 6.0 Koleksi menggantikan <isapiFilters> properti metabase FilterEnableCache dan FilterPath IIS 6.0.

Siapkan

Untuk menggunakan <isapiFilters> elemen , Anda harus menginstal modul Filter ISAPI di server IIS 7 dan yang lebih baru. Untuk melakukannya, gunakan langkah-langkah berikut.

Windows Server 2012 atau Windows Server 2012 R2

  1. Pada taskbar, klik Manajer Server.
  2. Di Manajer Server, klik menu Kelola , lalu klik Tambahkan Peran dan Fitur.
  3. Di wizard Tambahkan Peran dan Fitur , klik Berikutnya. Pilih jenis penginstalan dan klik Berikutnya. Pilih server tujuan dan klik Berikutnya.
  4. Pada halaman Peran Server , perluas Server Web (IIS), perluas Server Web, perluas Pengembangan Aplikasi, lalu pilih Filter ISAPI. Klik Berikutnya.
    Cuplikan layar simpul Web Server dan Fitur Pengembangan Aplikasi diperluas dengan Filter I S A P I dipilih. .
  5. Pada halaman Pilih fitur, klik Berikutnya.
  6. Pada halaman Konfirmasi pilihan instalasi, klik Instal.
  7. Pada halaman Hasil , klik Tutup.

Windows 8 atau Windows 8.1

  1. Pada layar Mulai, pindahkan penunjuk ke sudut kiri bawah, klik kanan tombol Mulai, lalu klik Panel Kontrol.
  2. Di Panel Kontrol, klik Program dan Fitur, lalu klik Aktifkan atau nonaktifkan fitur Windows.
  3. Perluas Layanan Informasi Internet, perluas World Wide Web Services, perluas Fitur Pengembangan Aplikasi, lalu pilih Filter ISAPI.
    Cuplikan layar menampilkan panel World Wide Web Services dan Fitur Pengembangan Aplikasi diperluas dengan Filter I S A P I yang dipilih.
  4. Klik OK.
  5. Klik Tutup.

Windows Server 2008 atau Windows Server 2008 R2

  1. Pada taskbar, klik Mulai, arahkan ke Alat Administratif, lalu klik Manajer Server.
  2. Di panel hierarki Manajer Server , perluas Peran, lalu klik Server Web (IIS).
  3. Di panel Server Web (IIS), gulir ke bagian Layanan Peran , lalu klik Tambahkan Layanan Peran.
  4. Pada halaman Pilih Layanan Peran dari Wizard Tambahkan Layanan Peran, pilih Filter ISAPI, lalu klik Berikutnya.
    Cuplikan layar node Fitur Pengembangan Aplikasi diperluas di halaman Aktifkan atau nonaktifkan fitur Windows yang menampilkan Filter I S A P I yang dipilih.
  5. Pada halaman Konfirmasi Pilihan Penginstalan , klik Instal.
  6. Pada halaman Hasil , klik Tutup.

Windows Vista atau Windows 7

  1. Pada taskbar, klik Mulai, lalu klik Panel Kontrol.
  2. Di Panel Kontrol, klik Program dan Fitur, lalu klik Aktifkan atau nonaktifkan Fitur Windows.
  3. Dalam kotak dialog Fitur Windows , perluas Layanan Informasi Internet, lalu World Wide Web Services, lalu Fitur Pengembangan Aplikasi.
    Cuplikan layar memperlihatkan panel World Wide Web Services dan Fitur Pengembangan Aplikasi diperluas dengan Filter I S A P I dipilih.
  4. Pilih Filter ISAPI, lalu klik OK.

Bagaimana Caranya

Cara menambahkan filter ISAPI

  1. Buka Pengelola 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 Pengelola 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 Pengelola Layanan Informasi Internet (IIS).

    • Jika Anda menggunakan Windows Vista atau Windows 7:

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

  2. Di panel Koneksi , buka koneksi atau situs yang ingin Anda konfigurasi filter ISAPI-nya.

  3. Di panel Beranda , klik dua kali Filter ISAPI.
    Cuplikan layar panel Beranda memperlihatkan Filter I S A P I dipilih.

  4. Di panel Tindakan , klik Tambahkan...

  5. Dalam kotak teks Nama filter dari kotak dialog Tambahkan Filter ISAPI , ketik nama yang mudah diingat untuk filter ISAPI.

  6. Dalam kotak Dapat Dieksekusi , ketik jalur sistem file lokasi file filter ISAPI atau klik elipsis (...) untuk menavigasi ke folder yang berisi file filter ISAPI, lalu klik OK.
    Cuplikan layar kotak dialog Tambahkan Filter I S A P I menampilkan kotak Yang Dapat Dieksekusi dan kotak Nama filter.

Konfigurasi

Atribut

Atribut Deskripsi
enableCache Atribut Boolean opsional.

Menentukan apakah penembolokan HTTP.sys diaktifkan (benar) atau dinonaktifkan (salah) untuk respons server yang difilter.

Nilai defaultnya adalah false.
enabled Atribut Boolean opsional.

Menentukan apakah filter yang diinstal diaktifkan (benar) atau dinonaktifkan (false).

Nilai defaultnya adalah true.
name Atribut string yang diperlukan.

Menentukan nama unik filter ISAPI.
path Atribut string yang diperlukan.

Menentukan jalur fisik lengkap file .dll filter ISAPI.
preCondition Atribut string opsional.

Menentukan kondisi di mana filter ISAPI 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 ketika filter ISAPI adalah file .dll 32-bit dan IIS harus memuat filter hanya untuk proses pekerja yang berjalan dalam mode WOW64 (simulasi 32-bit) pada sistem operasi 64-bit.
bitness64 Tentukan nilai bitness64 ketika filter ISAPI adalah file .dll 64-bit dan IIS harus memuat filter hanya untuk proses pekerja yang berjalan dalam mode 64-bit.
integratedMode Tentukan nilai integratedMode saat filter ISAPI harus menggunakan alur pemrosesan permintaan terintegrasi untuk memproses permintaan konten terkelola.
ISAPIMode Tentukan nilai ISAPIMode saat filter ISAPI harus menggunakan ekstensi ISAPI ASP.NET, Aspnet_isapi.dll, untuk memproses permintaan konten terkelola.
runtimeVersionv1.1 Tentukan nilai runtimeVersionv1.1 saat filter ISAPI harus dimuat hanya untuk kumpulan aplikasi yang dikonfigurasi untuk menggunakan .NET Framework versi 1.1.
runtimeVersionv2.0 Tentukan nilai runtimeVersionv2.0 saat filter ISAPI harus dimuat hanya untuk kumpulan aplikasi yang dikonfigurasi untuk menggunakan .NET Framework versi 2.0.

Elemen Anak

Tidak ada.

Sampel Konfigurasi

Contoh konfigurasi berikut menambahkan filter ISAPI bernama SalesQueryIsapi ke situs web atau aplikasi. Contoh nama dan mengaktifkan filter ISAPI dengan nama dan atribut yang diaktifkan . Ini juga menggunakan atribut enableCache untuk menonaktifkan penembolokan HTTP.sys dan atribut jalur untuk menentukan lokasi ISAPI DLL.

<configuration>
   <system.webServer>
      <isapiFilters>
         <filter 
            name="SalesFilter" 
            enabled="true" 
            enableCache="false" 
            path="C:\Inetpub\filters\SalesFilter.dll" />
      </isapiFilters>
   </system.webServer>
</configuration>

Kode Sampel

Contoh berikut mengonfigurasi filter ISAPI bernama SalesQueryIsapi di server. Setiap contoh menggunakan properti nama untuk menentukan nama untuk filter ISAPI, properti enableCache untuk menonaktifkan penembolokan HTTP.sys, dan properti jalur untuk menentukan lokasi ISAPI DLL.

AppCmd.exe

appcmd.exe set config -section:system.webServer/isapiFilters /+"[name='SalesQueryIsapi',path='c:\Inetpub\www.contoso.com\filters\SalesQueryIsapi.dll',enabled='True',enableCache='True']" /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 isapiFiltersSection = config.GetSection("system.webServer/isapiFilters");
         ConfigurationElementCollection isapiFiltersCollection = isapiFiltersSection.GetCollection();

         ConfigurationElement filterElement = isapiFiltersCollection.CreateElement("filter");
         filterElement["name"] = @"SalesQueryIsapi";
         filterElement["path"] = @"c:\Inetpub\www.contoso.com\filters\SalesQueryIsapi.dll";
         filterElement["enabled"] = true;
         filterElement["enableCache"] = true;
         isapiFiltersCollection.Add(filterElement);

         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 isapiFiltersSection As ConfigurationSection = config.GetSection("system.webServer/isapiFilters")
      Dim isapiFiltersCollection As ConfigurationElementCollection = isapiFiltersSection.GetCollection
      Dim filterElement As ConfigurationElement = isapiFiltersCollection.CreateElement("filter")
      filterElement("name") = "SalesQueryIsapi"
      filterElement("path") = "c:\Inetpub\www.contoso.com\filters\SalesQueryIsapi.dll"
      filterElement("enabled") = True
      filterElement("enableCache") = True
      isapiFiltersCollection.Add(filterElement)
      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var isapiFiltersSection = adminManager.GetAdminSection("system.webServer/isapiFilters", "MACHINE/WEBROOT/APPHOST");
var isapiFiltersCollection = isapiFiltersSection.Collection;

var filterElement = isapiFiltersCollection.CreateNewElement("filter");
filterElement.Properties.Item("name").Value = "SalesQueryIsapi";
filterElement.Properties.Item("path").Value = "c:\\Inetpub\\www.contoso.com\\filters\\SalesQueryIsapi.dll";
filterElement.Properties.Item("enabled").Value = true;
filterElement.Properties.Item("enableCache").Value = true;
isapiFiltersCollection.AddElement(filterElement);

adminManager.CommitChanges();

Vbscript

Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set isapiFiltersSection = adminManager.GetAdminSection("system.webServer/isapiFilters", "MACHINE/WEBROOT/APPHOST")
Set isapiFiltersCollection = isapiFiltersSection.Collection

Set filterElement = isapiFiltersCollection.CreateNewElement("filter")
filterElement.Properties.Item("name").Value = "SalesQueryIsapi"
filterElement.Properties.Item("path").Value = "c:\\Inetpub\\www.contoso.com\\filters\\SalesQueryIsapi.dll"
filterElement.Properties.Item("enabled").Value = True
filterElement.Properties.Item("enableCache").Value = True
isapiFiltersCollection.AddElement filterElement

adminManager.CommitChanges()