Ajout de documents par défaut <ajouter>

Vue d’ensemble

L’élément <add> de la collection <defaultDocument> spécifie un nom de fichier unique à ajouter à la liste des documents par défaut dans l’élément <files>.

Compatibilité

Programme d’installation

L’élément <add> de la collection <defaultDocument> est inclus dans l’installation par défaut IIS 7.

Procédure

Comment ajouter un document par défaut pour une application ou un site

1. Ouvrez le Gestionnaire des services Internet (IIS) :

   • Si vous utilisez Windows Server 2012 ou Windows Server 2012 R2 :

     • Dans la barre des tâches, cliquez sur Gestionnaire de serveur, cliquez sur Outils, puis sur Gestionnaire Internet Information Services (IIS).

   • Si vous utilisez Windows 8 ou Windows 8.1 :

     • Maintenez la touche Windows enfoncée, appuyez sur la lettre X, puis cliquez sur Panneau de configuration.
     • Cliquez sur Outils d’administration, puis double-cliquez sur Gestionnaire des services Internet (IIS).

   • Si vous utilisez Windows Server 2008 ou Windows Server 2008 R2 :

     • Cliquez sur Démarrer, placez le curseur sur Outils d'administration, puis cliquez sur Gestionnaire Internet Information Services (IIS).

   • Si vous utilisez Windows Vista ou Windows 7 :

     • Dans la barre des tâches, cliquez sur Démarrer, puis sur Panneau de configuration.
     • Double-cliquez sur Outils d'administration, puis double-cliquez sur Gestionnaire des services Internet (IIS).

2. Dans le volet Connexions, développez le nom du serveur, développez Sites, puis accédez au site Web ou à l’application web où vous souhaitez configurer les documents par défaut.

3. Dans le volet Accueil, double-cliquez sur Document par défaut.
   

4. Dans le volet Actions, cliquer sur Ajouter...

5. Dans la boîte de dialogue Ajouter un document par défaut, tapez le nom du document par défaut que vous souhaitez ajouter dans la zone Nom, puis cliquez sur OK.
   

6. Si nécessaire, dans le volet Actions, sélectionnez un document par défaut dans la liste, puis cliquez sur Déplacer vers le haut ou Déplacer vers le bas pour définir l’ordre dans lequel IIS doit effectuer une recherche dans la liste de documents par défaut.

7. Dans le message d’alerte Document par défaut, cliquez sur Oui pour refuser l’héritage de configuration à partir d’un niveau de configuration parent, ou cliquez sur Non ou Annuler pour annuler la modification dans l’ordre de document par défaut.
   

8. Si nécessaire, cliquez sur Supprimer dans le volet Actions pour supprimer les noms de fichiers que vous ne souhaitez pas utiliser comme documents par défaut.

Configuration

Attributs

Éléments enfants

Aucune.

Exemple Configuration

L’exemple de configuration suivant, lorsqu’il est inclus dans un fichier Web.config pour un site ou une application, active les documents par défaut pour le site ou l’application. Il ajoute ensuite le nom de fichier « Home.html » à la liste des documents par défaut du site ou de l’application.

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

Exemple de code

Les exemples suivants activent les documents par défaut sur un site web nommé Contoso, puis ajoutent un fichier nommé Home.html à la liste des documents par défaut pour le site.

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