Compartir a través de

Contenido estático <staticContent>

  • Artículo

Información general

El elemento <staticContent> configura varias opciones relacionadas con el procesamiento de solicitudes de archivos estáticos en Internet Information Services (IIS) 7.

El elemento <staticContent> contiene los tres siguientes atributos que especifican si IIS 7 debe aplicar un pie de página de documento a archivos estáticos:

  • El atributo enableDocFooter especifica si los pies de página de documento están habilitados.

  • El atributo defaultDocFooter contiene tanto:

    • Una cadena de texto que IIS 7 usará para el pie de página del documento si el atributo isDocFooterFileName está establecido en false
    • La ruta de acceso completa a un archivo con el texto que IIS 7 usará para el pie de página del documento si el atributo isDocFooterFileName está establecido en true.

  • Como se comentó anteriormente, el atributo isDocFooterFileName especifica si el atributo defaultDocFooter contiene una cadena de texto que IIS 7 usará para el pie de página del documento o ruta de acceso completa a un archivo con el texto que IIS 7 usará para el pie de página del documento.

Nota:

De forma predeterminada, el atributo isDocFooterFileName se establece en false y está bloqueado globalmente. Para usar archivos de pies de página de documento, debe establecer el atributo isDocFooterFileName en true en el nivel global o desbloquear el atributo. Para obtener más información sobre el bloqueo y desbloqueo de atributos, consulte el tutorial Cómo usar el bloqueo en IIS 7.0.

Compatibilidad

Versión Notas
IIS 10.0 El elemento <staticContent> no se modificó en IIS 10.0.
IIS 8.5 El elemento <staticContent> no se modificó en IIS 8.5.
IIS 8.0 El elemento <staticContent> no se modificó en IIS 8.0.
IIS 7.5 El elemento <staticContent> no se modificó en IIS 7.5.
IIS 7.0 El elemento <staticContent> se introdujo en IIS 7.0.
IIS 6,0 El elemento <staticContent> reemplaza las siguientes propiedades de metabase de IIS 6.0:
  • DefaultDocFooter
  • EnableDocFooter

Configuración

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

Procedimientos

No hay ninguna interfaz de usuario para configurar el elemento <staticContent> para IIS 7. Para obtener ejemplos de cómo configurar el elemento <staticContent> con programación, vea la sección Códigos de ejemplo de este documento.

Configuración

Atributos

Atributo Descripción
defaultDocFooter Atributo de cadena opcional.

Especifica el texto de pie de página predeterminado para cada página web de un sitio o la ruta de acceso de un archivo con el texto de pie de página predeterminado. Cómo IIS 7 usa esta propiedad depende del valor del atributo isDocFooterFileName.

Nota: el pie de página personalizado solo se enviará si el atributo enableDocFooter está establecido en true.
enableDocFooter Atributo Boolean opcional.

Especifica si el texto que indica el atributo defaultDocFooter aparecerá en cada página estática de un sitio web.

El valor predeterminado es false.
isDocFooterFileName Atributo Boolean opcional.

Especifica si la cadena del atributo defaultDocFooter contiene una ruta de acceso de un archivo con el texto de pie de página predeterminado de cada página web estática de un sitio.

El valor predeterminado es false.

Elementos secundarios

Elemento Descripción
clientCache Elemento opcional.

Especifica la configuración para almacenar en caché el contenido estático que se envía al cliente.
mimeMap Elemento opcional.

Especifica una lista de las extensiones de nombre de archivo de las asignaciones MIME.

Ejemplo de configuración

El siguiente ejemplo de configuración habilita un pie de página de documento con contenido estático y agrega un aviso sencillo de copyright como texto del pie de página.

<configuration>
   <system.webServer>
      <staticContent enableDocFooter="true"
         defaultDocFooter="The information in this web site is copyrighted." />
   </system.webServer>
</configuration>

Código de ejemplo

El siguiente código de ejemplo habilita un pie de página de documento de contenido estático y agrega un aviso de copyright simple como texto del pie de página.

AppCmd.exe

appcmd.exe set config "Default Web Site" -section:system.webServer/staticContent /enableDocFooter:"True"

appcmd.exe set config "Default Web Site" -section:system.webServer/staticContent /defaultDocFooter:"The information in this web site is copyrighted."

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("Default Web Site");

         ConfigurationSection staticContentSection = config.GetSection("system.webServer/staticContent");
         staticContentSection["defaultDocFooter"] = @"The information in this web site is copyrighted.";
         staticContentSection["enableDocFooter"] = true;

         serverManager.CommitChanges();
      }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample

   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetWebConfiguration("Default Web Site")

      Dim staticContentSection As ConfigurationSection = config.GetSection("system.webServer/staticContent")
      staticContentSection("defaultDocFooter") = "The information in this web site is copyrighted."
      staticContentSection("enableDocFooter") = True

      serverManager.CommitChanges()
   End Sub

End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST/Default Web Site";

var staticContentSection = adminManager.GetAdminSection("system.webServer/staticContent", "MACHINE/WEBROOT/APPHOST/Default Web Site");
staticContentSection.Properties.Item("defaultDocFooter").Value = "The information in this web site is copyrighted.";
staticContentSection.Properties.Item("enableDocFooter").Value = true;

adminManager.CommitChanges();

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST/Default Web Site"

Set staticContentSection = adminManager.GetAdminSection("system.webServer/staticContent", "MACHINE/WEBROOT/APPHOST/Default Web Site")
staticContentSection.Properties.Item("defaultDocFooter").Value = "The information in this web site is copyrighted."
staticContentSection.Properties.Item("enableDocFooter").Value = True

adminManager.CommitChanges()