Standarddokumentdateien <files>

Übersicht

Das <files>-Element der <defaultDocument>-Sammlung gibt eine Liste mit Dateinamen an, die als Standarddokumente konfiguriert sind. Das <files>-Element kann eine Liste von <add>-Elementen enthalten. Jedes Element in der Liste gibt eine eindeutige Datei an, die der <files>-Liste hinzugefügt werden soll.

Kompatibilität

Setup

Das <files>-Element der <defaultDocument>-Sammlung ist in der Standardinstallation von IIS 7 enthalten.

Gewusst wie

Hinzufügen eines Standarddokuments für eine Anwendung oder Site

1. Öffnen Sie Internetinformationsdienste-Manager (IIS-Manager):

   • Vorgehensweise unter Windows Server 2012 oder Windows Server 2012 R2:

     • Klicken Sie auf der Taskleiste auf Server-Manager > Tools > Internetinformationsdienste-Manager (IIS-Manager).

   • Vorgehensweise unter Windows 8 oder Windows 8.1:

     • Halten Sie die WINDOWS-TASTE gedrückt, drücken Sie den Buchstaben X, und klicken Sie dann auf Systemsteuerung.
     • Klicken Sie auf Verwaltung, und doppelklicken Sie dann auf Internetinformationsdienste-Manager (IIS-Manager).

   • Vorgehensweise unter Windows Server 2008 oder Windows Server 2008 R2:

     • Klicken Sie auf der Taskleiste auf Start, zeigen Sie auf Verwaltung, und klicken Sie dann auf Internetinformationsdienste-Manager (IIS-Manager).

   • Vorgehensweise unter Windows Vista oder Windows 7:

     • Klicken Sie auf der Taskleiste auf Start und dann auf Systemsteuerung.
     • Doppelklicken Sie auf Verwaltung, und doppelklicken Sie dann auf Internetinformationsdienste-Manager (IIS-Manager).

2. Erweitern Sie im Bereich Verbindungen den Servernamen, erweitern Sie Sites, und navigieren Sie dann zu der Website oder Anwendung, für die Sie Standarddokumente konfigurieren möchten.

3. Doppelklicken Sie im Bereich Start auf Standarddokument.
   

4. Klicken Sie im Bereich Aktionen auf Hinzufügen....

5. Geben Sie im Dialogfeld Standarddokument hinzufügen im Feld Name den Namen des Standarddokuments ein, das Sie hinzufügen möchten, und klicken Sie anschließend auf OK.
   

6. Wählen Sie bei Bedarf im Bereich Aktionen ein Standarddokument aus der Liste aus, und klicken Sie anschließend auf Nach oben oder Nach unten, um die Reihenfolge zu definieren, in der IIS die Standarddokumentliste durchsuchen soll.

7. Klicken Sie im Benachrichtigungsfeld Standarddokument auf Ja, um die Konfigurationsvererbung von einer übergeordneten Konfigurationsebene abzulehnen, oder klicken Sie auf Nein oder Abbrechen, um die Änderung der Standarddokumentreihenfolge abzubrechen.
   

8. Klicken Sie bei Bedarf im Bereich Aktionen auf Entfernen, um Dateinamen zu entfernen, die nicht als Standarddokumente verwendet werden sollen.

Konfiguration

Attribute

Keine

Untergeordnete Elemente

Konfigurationsbeispiel

Wenn das folgende Konfigurationsbeispiel in die Datei „Web.config“ für eine Site oder Anwendung eingeschlossen wird, werden Standarddokumente für die Site oder Anwendung aktiviert. Anschließend wird der Dateiname „Home.html“ zur Liste der Standarddokumente der Site oder Anwendung hinzugefügt.

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

Beispielcode

In den folgenden Beispielen werden Standarddokumente für eine Website namens „Contoso“ aktiviert. Anschließend wird eine Datei mit dem Namen „Home.html“ zur Liste der Standarddokumente für die Site hinzugefügt.

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