Bagikan melalui

ASP <asp>

  • Artikel

Gambaran Umum

Elemen <asp> menentukan pengaturan konfigurasi untuk aplikasi ASP. Ini termasuk pengaturan konfigurasi yang berfokus pada pengembang, seperti atribut yang mengontrol pengaturan penelusuran kesalahan dan pengembalian kesalahan. Elemen ini <asp> juga menyertakan atribut yang mengontrol kumpulan karakter yang digunakan oleh aplikasi, bahasa skrip untuk aplikasi, dan apakah pencatatan kesalahan diaktifkan untuk aplikasi.

Elemen ini <asp> juga dapat berisi elemen yang mengonfigurasi COM+, penembolokan ASP, batas buffering, dan status sesi untuk situs atau aplikasi.

Kompatibilitas

Versi Catatan
IIS 10.0 Elemen <asp> tidak dimodifikasi di IIS 10.0.
IIS 8.5 Elemen <asp> tidak dimodifikasi di IIS 8.5.
IIS 8.0 Elemen <asp> tidak dimodifikasi di IIS 8.0.
IIS 7.5 Elemen <asp> tidak dimodifikasi dalam IIS 7.5.
IIS 7.0 Elemen <asp> ini diperkenalkan di IIS 7.0.
IIS 6.0 Elemen <asp> dan turunannya menggantikan properti terkait ASP di objek IIS 6.0 IIsWebService .

Siapkan

Untuk mendukung dan mengonfigurasi aplikasi ASP di server Web, Anda harus menginstal modul ASP. Untuk menginstal modul ASP, 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 ASP.
    Cuplikan layar yang memperlihatkan A S P dipilih untuk Windows Server 2012.
  5. Jika kotak dialog Tambahkan fitur yang diperlukan oleh ASP? muncul, klik Tambahkan Fitur. (Halaman ini hanya muncul jika Anda belum menginstal layanan peran Ekstensi ISAPI di server Anda.)
  6. Pada halaman Peran Server, klik Berikutnya.
  7. Pada halaman Pilih fitur, klik Berikutnya.
  8. Pada halaman Konfirmasi pilihan instalasi, klik Instal.
  9. 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 ASP.
    Cuplikan layar yang memperlihatkan A S P dipilih untuk Windows 8.

    Catatan

    Peran Ekstensi ISAPI akan dipilih jika belum diinstal.

  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 ASP.
    Cuplikan layar yang memperlihatkan A S P dipilih untuk Windows Server 2008.
  5. Jika kotak dialog Tambahkan layanan peran yang diperlukan oleh ASP muncul, klik Tambahkan Layanan Peran yang Diperlukan. (Halaman ini hanya muncul jika Anda belum menginstal layanan peran Ekstensi ISAPI di server Anda.)
    Cuplikan layar yang memperlihatkan kotak dialog Tambahkan Layanan Peran.
  6. Pada halaman Pilih Layanan Peran , klik Berikutnya.
  7. Pada halaman Konfirmasi Pilihan Penginstalan , klik Instal.
  8. 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. Perluas Layanan Informasi Internet, lalu World Wide Web Services, lalu Fitur Pengembangan Aplikasi.
  4. Pilih ASP, lalu klik OK.
    Cuplikan layar kotak dialog Fitur Windows. S P dipilih di bawah simpul Fitur Pengembangan Aplikasi.

Bagaimana Caranya

Cara mengonfigurasi pengaturan ASP untuk situs atau 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 taskbar, klik Mulai, arahkan ke Alat Administratif, lalu klik Manajer 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 , perluas nama server, perluas Situs, lalu navigasikan ke situs Web atau aplikasi Web yang ingin Anda konfigurasi.

  3. Di panel Beranda situs atau aplikasi, klik dua kali ASP.
    Cuplikan layar yang memperlihatkan panel Beranda Situs Web Default. S P dipilih.

  4. Di panel ASP , konfigurasikan pengaturan yang diperlukan, lalu klik Terapkan di panel Tindakan .
    Cuplikan layar yang memperlihatkan panel A S P di I S Manager.

Konfigurasi

Anda dapat mengonfigurasi <asp> elemen di tingkat server dalam file ApplicationHost.config. Namun, secara default, Anda tidak dapat mengonfigurasi <asp> elemen di tingkat situs atau tingkat aplikasi.

Atribut

Atribut Deskripsi
appAllowClientDebug Atribut Boolean opsional. Menentukan apakah penelusuran kesalahan sisi klien diaktifkan. Nilai defaultnya adalah false.
appAllowDebugging Atribut Boolean opsional. Menentukan apakah penelusuran kesalahan sisi server diaktifkan. Nilai defaultnya adalah false.
bufferingOn Atribut Boolean opsional. Menentukan apakah buffering output aplikasi ASP diaktifkan. Nilai defaultnya adalah true.
calcLineNumber Atribut Boolean opsional. Menentukan apakah ASP menghitung dan menyimpan nomor baris dari setiap baris kode yang dijalankan untuk memberikan angka dalam laporan kesalahan. Nilai defaultnya adalah true.
codePage Atribut uint opsional. Menentukan set karakter default untuk aplikasi ASP. Nilai ini adalah bilangan bulat dalam rentang dari 0 hingga 2147483647. Misalnya, nilai 1252 mengatur karakter default yang diatur ke set karakter Latin yang digunakan dalam bahasa Inggris Amerika dan banyak alfabet Eropa. Nilai defaultnya adalah 0.
enableApplicationRestart Atribut Boolean opsional. Menentukan apakah aplikasi ASP secara otomatis dimulai ulang setiap kali pengaturan konfigurasi diubah. Nilai defaultnya adalah true.
enableAspHtmlFallback Atribut Boolean opsional. Menentukan apakah file .htm dengan nama yang sama dengan file .asp yang diminta, jika ada, akan dikirim ke klien alih-alih file .asp. Ini akan terjadi jika permintaan ditolak karena antrean permintaan penuh. Nilai defaultnya adalah true.
enableChunkedEncoding Atribut Boolean opsional. Menentukan apakah pengodean transfer terpotong HTTP 1.1 diaktifkan. Nilai defaultnya adalah true.
enableParentPaths Atribut Boolean opsional. Menentukan apakah halaman ASP memperbolehkan jalur relatif terhadap direktori saat ini atau di atas direktori saat ini. Nilai defaultnya adalah false.
errorsToNTLog Atribut Boolean opsional. Menentukan apakah pengelogan kesalahan ASP ke Log Peristiwa Windows diaktifkan. Nilai defaultnya adalah false.
exceptionCatchEnable Atribut Boolean opsional. Menentukan apakah trapping pengecualian komponen COM diaktifkan. Jika diatur ke false, alat Microsoft Script Debugger tidak menangkap pengecualian yang dikirim oleh komponen yang Anda debugging. Nilai defaultnya adalah true.
lcid Atribut uint opsional. Menentukan pengidentifikasi lokal default untuk aplikasi ASP. Nilai ini adalah bilangan bulat dalam rentang dari 0 hingga 2147483647. Nilai defaultnya adalah 0.
logErrorRequests Atribut Boolean opsional.

Menentukan apakah kesalahan ASP ditulis ke browser klien dan log IIS secara default.

Nilai defaultnya adalah true.
runOnEndAnonymously Atribut Boolean opsional. Menentukan apakah fungsi ASP global SessionOnEnd dan ApplicationOnEnd dijalankan sebagai pengguna anonim. Nilai defaultnya adalah true.
scriptErrorMessage Atribut string opsional. Menentukan pesan kesalahan yang akan dikirim ke browser ketika kesalahan penelusuran kesalahan tertentu tidak dikirim ke klien. Nilai defaultnya adalah An error occurred on the server when processing the URL. Please contact the system administrator.
scriptErrorSentToBrowser Atribut Boolean opsional. Menentukan apakah penulisan penelusuran kesalahan khusus untuk browser klien diaktifkan. Nilai defaultnya adalah false.
scriptLanguage Atribut string opsional. Menentukan bahasa skrip default untuk semua aplikasi ASP yang berjalan di server Web. Nilai defaultnya adalah VBScript.

Elemen Anak

Elemen Deskripsi
cache Elemen opsional.

Menentukan pengaturan cache ASP.
comPlus Elemen opsional.

Menentukan pengaturan COM+.
limits Elemen opsional.

Menentukan batas untuk berbagai properti ASP.
session Elemen opsional.

Menentukan pengaturan status sesi ASP.

Sampel Konfigurasi

Contoh konfigurasi berikut memungkinkan buffering dan keadaan sesi untuk aplikasi ASP di situs bernama Contoso, dan menonaktifkan jalur induk untuk situs yang sama.

<location path="Contoso">
   <system.webServer>
      <asp enableParentPaths="false" bufferingOn="true">
         <session allowSessionState="true" />
      </asp>
   </system.webServer>
</location>

Kode Sampel

Contoh kode berikut mengaktifkan buffering dan keadaan sesi untuk aplikasi ASP di situs bernama Contoso, dan menonaktifkan jalur induk untuk situs yang sama.

AppCmd.exe

appcmd.exe set config "Contoso" -section:system.webServer/asp /enableParentPaths:"False" /commit:apphost
appcmd.exe set config "Contoso" -section:system.webServer/asp /bufferingOn:"True" /commit:apphost
appcmd.exe set config "Contoso" -section:system.webServer/asp /session.allowSessionState:"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 aspSection = config.GetSection("system.webServer/asp", "Contoso");
         aspSection["enableParentPaths"] = false;
         aspSection["bufferingOn"] = true;

         ConfigurationElement sessionElement = aspSection.GetChildElement("session");
         sessionElement["allowSessionState"] = true;

         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 aspSection As ConfigurationSection = config.GetSection("system.webServer/asp", "Contoso")
      aspSection("enableParentPaths") = False
      aspSection("bufferingOn") = True
      Dim sessionElement As ConfigurationElement = aspSection.GetChildElement("session")
      sessionElement("allowSessionState") = True
      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";

var aspSection = adminManager.GetAdminSection("system.webServer/asp", "MACHINE/WEBROOT/APPHOST/Contoso");
aspSection.Properties.Item("enableParentPaths").Value = false;
aspSection.Properties.Item("bufferingOn").Value = true;
var sessionElement = aspSection.ChildElements.Item("session");
sessionElement.Properties.Item("allowSessionState").Value = true;

adminManager.CommitChanges();

Vbscript

Set adminManager = CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"

Set aspSection = adminManager.GetAdminSection("system.webServer/asp", "MACHINE/WEBROOT/APPHOST/Contoso")
aspSection.Properties.Item("enableParentPaths").Value = False
aspSection.Properties.Item("bufferingOn").Value = True
Set sessionElement = aspSection.ChildElements.Item("session")
sessionElement.Properties.Item("allowSessionState").Value = True

adminManager.CommitChanges()