Bagikan melalui

File <Dokumen Default>

Gambaran Umum

Elemen <files><defaultDocument> koleksi menentukan daftar nama file yang dikonfigurasi sebagai dokumen default. Elemen <files> dapat berisi daftar <add> elemen di mana setiap item dalam daftar menentukan file unik untuk ditambahkan ke <files> daftar.

Kompatibilitas

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

Siapkan

Elemen <files><defaultDocument> koleksi 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 Dokumen Default dipilih di panel Beranda Situs Web Default.

  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 menambahkan Dokumen Default baru bernama home dot H T M L.

  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 memperingatkan Anda sebelum mewarisi konfigurasi tingkat induk untuk dokumen default baru.

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

Konfigurasi

Atribut

Tidak ada.

Elemen Anak

Elemen Deskripsi
add Elemen opsional.

Menambahkan nama file ke kumpulan file.
remove Elemen opsional.

Menghapus referensi ke nama file dari kumpulan file.
clear Elemen opsional.

Menghapus semua referensi ke nama file dari kumpulan file.

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