Hinzufügen von Standarddokumentdateien <add>

Artikel
03/25/2024

Übersicht

Das <add>-Element der <defaultDocument>-Sammlung gibt einen eindeutigen Dateinamen an, der der Liste der Standarddokumente im <files>-Element hinzugefügt werden soll.

Kompatibilität

Version	Hinweise
IIS 10.0	Das `<add>`-Element wurde in IIS 10.0 nicht geändert.
IIS 8.5	Das `<add>`-Element wurde in IIS 8.5 nicht geändert.
IIS 8.0	Das `<add>`-Element wurde in IIS 8.0 nicht geändert.
IIS 7.5	Das `<add>`-Element wurde in IIS 7.5 nicht geändert.
IIS 7.0	Das `<add>`-Element der `<defaultDocument>`-Sammlung wurde in IIS 7.0 eingeführt.
IIS 6.0	Die `<defaultDocument>`-Sammlung ersetzt die IIS 6.0-Eigenschaft DefaultDoc und den Wert EnableDefaultDoc der Eigenschaft DirBrowseFlags für das IIsWebService-Metabasisobjekt.

Setup

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

Gewusst wie

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

Ö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).
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.
Doppelklicken Sie im Bereich Start auf Standarddokument.
Klicken Sie im Bereich Aktionen auf Hinzufügen....
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.
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.
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.
Klicken Sie bei Bedarf im Bereich Aktionen auf Entfernen, um Dateinamen zu entfernen, die nicht als Standarddokumente verwendet werden sollen.

Konfiguration

Attribute

Attribut	Beschreibung
`name`	Optionales Zeichenfolgeattribut. Gibt einen Dateinamen eines Webinhalts an, der als Standarddokument verwendet werden kann. Der Wert muss in der Dateisammlung eindeutig sein und kann ein Dateiname oder ein relativer Pfad sein.

Untergeordnete Elemente

Keine.

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

Freigeben über