Archivos de documentos predeterminados <files>

Información general

El elemento <files> de la colección <defaultDocument> especifica una lista de nombres de archivo que se configuran como documentos predeterminados. El elemento <files> puede contener una lista de elementos <add> donde cada elemento de la lista especifica un archivo único que se va a agregar a la lista <files>.

Compatibilidad

Versión	Notas
IIS 10.0	El elemento <files> no se modificó en IIS 10.0.
IIS 8.5	El elemento <files> no se modificó en IIS 8.5.
IIS 8.0	El elemento <files> no se modificó en IIS 8.0.
IIS 7.5	El elemento <files> no se modificó en IIS 7.5.
IIS 7.0	El elemento <files> de la colección <defaultDocument> se incluyó por primera vez en IIS 7.0.
IIS 6,0	La colección <defaultDocument> reemplaza la propiedad DefaultDoc de IIS 6.0 y el valor EnableDefaultDoc de la propiedad DirBrowseFlags en el objeto de metabase IIsWebService.

Configuración

El elemento <files> de la colección <defaultDocument> se incluye en la instalación predeterminada de IIS 7.

Procedimientos

Cómo agregar un documento predeterminado para una aplicación o un sitio

1. Abra el Administrador de Internet Information Services (IIS):

   • Si usa Windows Server 2012 o Windows Server 2012 R2:

     • En la barra de tareas, haga clic en Administrador del servidor, en Herramientas y, a continuación, en Administrador de Internet Information Services (IIS).

   • Si usa Windows 8 o Windows 8.1:

     • Mantenga presionada la tecla Windows, presione la letra X y haga clic en Panel de control.
     • Haga clic en Herramientas administrativas y, a continuación, haga doble clic en Administrador de Internet Information Services (IIS).

   • Si usa Windows Server 2008 o Windows Server 2008 R2:

     • En la barra de tareas, haga clic en Inicio, seleccione Herramientas administrativas y, a continuación, haga clic en Administrador de Internet Information Services (IIS).

   • Si usa Windows Vista o Windows 7:

     • En la barra de tareas, haga clic en Inicio y, luego, haga clic en Panel de control.
     • Haga doble clic en Herramientas administrativas y, a continuación, haga doble clic en Administrador de Internet Information Services (IIS).

2. En el panel Conexiones, expanda el nombre del servidor, expanda Sitios y, a continuación, vaya a la aplicación o al sitio web donde quiere configurar los documentos predeterminados.

3. En el panel Inicio, haga doble clic en Documento predeterminado.
   

4. En el panel Acciones, haga clic en Agregar....

5. En el cuadro de diálogo Agregar documento predeterminado, escriba el nombre del documento predeterminado que quiere agregar en el cuadro Nombre y, a continuación, haga clic en Aceptar.
   

6. Si es necesario, en el panel Acciones, seleccione un documento predeterminado de la lista y, a continuación, haga clic en Subir o Bajar para definir el orden en el que IIS debe buscar en la lista de documentos predeterminados.

7. En el cuadro de alerta Documento predeterminado, haga clic en Sí para rechazar la herencia de configuración de un nivel de configuración primario, o bien haga clic en No o en Cancelar para cancelar el cambio en el orden de los documentos predeterminados.
   

8. Si es necesario, haga clic en Quitar en el panel Acciones para quitar los nombres de archivo que no quiera usar como documentos predeterminados.

Configuración

Atributos

Ninguno.

Elementos secundarios

Elemento	Descripción
add	Elemento opcional. Agrega un nombre de archivo a la colección de archivos.
remove	Elemento opcional. Quita una referencia a un nombre de archivo de la colección de archivos.
clear	Elemento opcional. Quita todas las referencias a los nombres de archivo de la colección de archivos.

Ejemplo de configuración

El ejemplo de configuración siguiente, cuando se incluye en un archivo Web.config para un sitio o aplicación, habilita documentos predeterminados para el sitio o la aplicación. Después, agrega el nombre de archivo "Home.html" a la lista de documentos predeterminados del sitio o de la aplicación.

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

Código de ejemplo

En los ejemplos siguientes se habilitan documentos predeterminados en un sitio web llamado Contoso y, después, se agrega un archivo denominado Home.html a la lista de documentos predeterminados del sitio.

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