Bagikan melalui

Default Document <defaultDocument>

  • Artikel

Gambaran Umum

Elemen ini <defaultDocument> memungkinkan Anda mengaktifkan atau menonaktifkan perilaku dokumen default untuk situs web atau aplikasi Anda. Elemen ini berisi <files> elemen turunan <add> , yang berisi kumpulan elemen. Setiap <add> elemen menentukan dokumen default yang akan dikembalikan situs atau aplikasi ke browser klien ketika situs menerima permintaan ke direktori akar.

Elemen ini <defaultDocument> juga dapat berisi satu atau beberapa <remove> elemen. Setiap <remove> elemen menghapus file dokumen default tertentu yang diwarisi dari file konfigurasi tingkat yang lebih tinggi di server Internet Information Services (IIS) 7. Anda juga dapat menggunakan <clear> elemen untuk menghapus semua pengaturan dokumen default yang ditentukan lebih tinggi dalam hierarki konfigurasi.

Dokumen default diaktifkan secara default, dan IIS 7 menentukan file dokumen default berikut dalam file ApplicationHost.config sebagai default di seluruh server:

  • Default.htm
  • Default.asp
  • Index.htm
  • Index.html
  • Iisstart.htm

(Jika Anda menginstal ASP.NET di server Web Anda, proses penginstalan akan menambahkan file Default.aspx ke daftar ini.)

Secara default, ketika permintaan tiba untuk direktori akar situs atau aplikasi Anda, IIS 7 mengirimkan respons ke browser berdasarkan nama file yang Anda tentukan dalam <defaultDocument> elemen . IIS mencoba mengembalikan file yang benar dalam urutan yang muncul di <defaultDocument> elemen . Jika file Default.htm ada, IIS mengirimkannya ke browser klien. Jika file Default.htm tidak ada, IIS mencoba mengirim file Default.asp ke browser, dan jika file Default.asp tidak ada, IIS mencoba mengirim file Index.htm ke browser. IIS berlanjut dengan cara ini sampai mencoba mengirim setiap file dokumen default ke browser klien.

Catatan

Jika Anda memesan daftar dokumen default ini dengan benar, Anda dapat meningkatkan performa IIS. Misalnya, jika Anda berniat menggunakan Index.php untuk halaman beranda di semua folder situs Web Anda dan Anda menambahkan Index.php ke bagian bawah daftar dokumen default, IIS harus memeriksa setiap dokumen default dalam daftar sebelum mencoba mengembalikan Index.php ke browser klien. Bergantung pada jumlah folder di situs Web Anda dan jumlah permintaan browser klien, ini dapat memengaruhi performa Anda.

Jika Anda menonaktifkan dokumen default tetapi telah mengaktifkan penjelajahan direktori, IIS mengembalikan daftar direktori saat permintaan direktori akar tiba dari browser. Jika Anda menonaktifkan penjelajahan dokumen dan direktori default, IIS mengirimkan kesalahan "File HTTP 404 Tidak Ada" ke browser.

Kompatibilitas

Versi Catatan
IIS 10.0 Elemen <defaultDocument> tidak dimodifikasi dalam IIS 10.0.
IIS 8.5 Elemen <defaultDocument> tidak dimodifikasi dalam IIS 8.5.
IIS 8.0 Elemen <defaultDocument> tidak dimodifikasi dalam IIS 8.0.
IIS 7.5 Elemen <defaultDocument> tidak dimodifikasi dalam IIS 7.5.
IIS 7.0 Elemen ini <defaultDocument> diperkenalkan di IIS 7.0.
IIS 6.0 Elemen menggantikan <defaultDocument> properti DefaultDoc IIS 6.0 dan nilai EnableDefaultDoc dari properti DirBrowseFlags pada objek metabase IIsWebService .

Siapkan

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

Bagaimana Caranya

Cara menambahkan dokumen default untuk aplikasi atau situs

  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 , perluas nama server, perluas Situs, lalu navigasikan ke situs Web atau aplikasi tempat Anda ingin mengonfigurasi dokumen default.

  3. Di panel Beranda , klik dua kali Dokumen Default.
    Cuplikan layar panel Beranda dengan opsi Dokumen Default sedang disorot.

  4. Di panel Tindakan , klik Tambahkan...

  5. Dalam kotak dialog Tambahkan Dokumen Default , ketik nama dokumen default yang ingin Anda tambahkan dalam kotak Nama , lalu klik OK.
    Cuplikan layar kotak dialog Tambahkan Dokumen Default.

  6. Jika perlu, di panel Tindakan , pilih dokumen default dalam daftar, lalu klik Pindah ke Atas atau Pindah ke Bawah untuk menentukan urutan di mana IIS harus mencari melalui daftar dokumen default.

  7. Dalam kotak pemberitahuan Dokumen Default , klik Ya untuk menolak pewarisan konfigurasi dari tingkat konfigurasi induk, atau klik Tidak atau Batal untuk membatalkan perubahan dalam urutan dokumen default.
    Cuplikan layar kotak pemberitahuan Dokumen Default dengan fokus pada opsi Ya.

  8. Jika perlu, klik Hapus di panel Tindakan untuk menghapus nama file apa pun yang tidak ingin Anda gunakan sebagai dokumen default.

Konfigurasi

Anda dapat mengubah urutan di mana IIS memproses dokumen default dengan mengubah urutan <add> elemen dalam <defaultDocument> elemen .

Anda dapat mengonfigurasi <defaultDocument> elemen di tingkat server dalam file ApplicationHost.config dan di tingkat situs, aplikasi, atau URL dalam file Web.config yang sesuai.

Atribut

Atribut Deskripsi
enabled Atribut Boolean opsional.

Menentukan bahwa dokumen default diaktifkan.

Nilai defaultnya adalah true.

Elemen Anak

Elemen Deskripsi
files Elemen opsional.

Menentukan daftar nama file yang dapat dikembalikan sebagai dokumen default.

Sampel Konfigurasi

Contoh konfigurasi berikut, ketika disertakan dalam file Web.config untuk situs atau aplikasi, memungkinkan dokumen default untuk situs atau aplikasi. Kemudian menambahkan nama file "Home.html" ke daftar dokumen default situs atau aplikasi.

<configuration>
   <system.webServer>
      <defaultDocument enabled="true">
         <files>
            <add value="home.html" />
         </files>
      </defaultDocument>
   </system.webServer>
</configuration>

Kode Sampel

Contoh berikut mengaktifkan dokumen default pada situs Web bernama Contoso lalu menambahkan file bernama Home.html ke daftar dokumen default untuk situs tersebut.

AppCmd.exe

appcmd.exe set config "Contoso" /section:defaultDocument /enabled:true /+files.[value='home.html']

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 defaultDocumentSection = config.GetSection("system.webServer/defaultDocument");
            
            defaultDocumentSection["enabled"] = true;
            
            ConfigurationElementCollection filesCollection = defaultDocumentSection.GetCollection("files");
            ConfigurationElement addElement = filesCollection.CreateElement("add");
            addElement["value"] = @"home.html";
            filesCollection.AddAt(0, addElement);
            
            serverManager.CommitChanges();
        }
    }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Class Sample
   Shared Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetWebConfiguration("Contoso")
      Dim defaultDocumentSection As ConfigurationSection = config.GetSection("system.webServer/defaultDocument")

      defaultDocumentSection("enabled") = True

      Dim filesCollection As ConfigurationElementCollection = defaultDocumentSection.GetCollection("files")
      Dim addElement As ConfigurationElement = filesCollection.CreateElement("add")
      addElement("value") = "home.html"
      filesCollection.AddAt(0, addElement)

      serverManager.CommitChanges()
   End Sub
End Class

JavaScript

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

var defaultDocumentSection = adminManager.GetAdminSection("system.webServer/defaultDocument",
   "MACHINE/WEBROOT/APPHOST/Contoso");

defaultDocumentSection.Properties.Item("enabled").Value = true;

var filesCollection = defaultDocumentSection.ChildElements.Item("files").Collection;

var addElement = filesCollection.CreateNewElement("add");
addElement.Properties.Item("value").Value = "home.html";
filesCollection.AddElement(addElement, 0);

adminManager.CommitChanges();

Vbscript

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

Set defaultDocumentSection = adminManager.GetAdminSection("system.webServer/defaultDocument", _
   "MACHINE/WEBROOT/APPHOST/Contoso")

defaultDocumentSection.Properties.Item("enabled").Value = True  

Set filesCollection = defaultDocumentSection.ChildElements.Item("files").Collection

Set addElement = filesCollection.CreateNewElement("add")
addElement.Properties.Item("value").Value = "home.html"
filesCollection.AddElement addElement, 0

adminManager.CommitChanges