Contenuto <staticoContent statico>

  • Articolo

Panoramica

L'elemento configura diverse impostazioni correlate all'elaborazione <staticContent> delle richieste per i file statici in Internet Information Services (IIS) 7.

L'elemento <staticContent> contiene i tre attributi seguenti che specificano se IIS 7 deve applicare un piè di pagina del documento ai file statici:

  • L'attributo enableDocFooter specifica se i piè di pagina dei documenti sono abilitati.

  • L'attributo defaultDocFooter contiene entrambi:

    • Stringa di testo che IIS 7 userà per il piè di pagina del documento se l'attributo isDocFooterFileName è impostato su false
    • Percorso completo di un file contenente il testo che IIS 7 userà per il piè di pagina del documento se l'attributo isDocFooterFileName è impostato su true.

  • Come indicato in precedenza, l'attributo isDocFooterFileName specifica se l'attributo defaultDocFooter contiene una stringa di testo che IIS 7 userà per il piè di pagina del documento o il percorso completo di un file contenente il testo che IIS 7 userà per il piè di pagina del documento.

Nota

Per impostazione predefinita, l'attributo isDocFooterFileName è impostato su false e bloccato a livello globale. Per usare i file per i piè di pagina dei documenti, è necessario impostare l'attributo isDocFooterFileName su true a livello globale o sbloccare l'attributo. Per altre informazioni sui blocchi e sugli attributi di sblocco, vedere la procedura dettagliata Come usare il blocco in IIS 7.0 Configurazione .

Compatibilità

Versione Note
IIS 10.0 L'elemento <staticContent> non è stato modificato in IIS 10.0.
IIS 8,5 L'elemento <staticContent> non è stato modificato in IIS 8.5.
IIS 8,0 L'elemento <staticContent> non è stato modificato in IIS 8.0.
IIS 7,5 L'elemento <staticContent> non è stato modificato in IIS 7.5.
IIS 7.0 L'elemento <staticContent> è stato introdotto in IIS 7.0.
IIS 6.0 L'elemento <staticContent> sostituisce le proprietà metabase di IIS 6.0 seguenti:
  • DefaultDocFooter
  • EnableDocFooter

Installazione

L'elemento <staticContent> è incluso nell'installazione predefinita di IIS 7.

Procedure

Non esiste un'interfaccia utente per configurare l'elemento <staticContent> per IIS 7. Per esempi di come configurare l'elemento a livello di codice, vedere la <staticContent> sezione Esempi di codice di questo documento.

Configurazione

Attributi

Attributo Descrizione
defaultDocFooter Attributo stringa facoltativo.

Specifica il testo del piè di pagina predefinito per ogni pagina Web in un sito o il percorso di un file contenente il testo del piè di pagina predefinito. In che modo IIS 7 usa questa proprietà dipende dal valore dell'attributo isDocFooterFileName .

Nota: Il piè di pagina personalizzato verrà inviato solo se l'attributo enableDocFooter è impostato su true.
enableDocFooter Attributo booleano facoltativo.

Specifica se il testo indicato dall'attributo defaultDocFooter verrà visualizzato in ogni pagina statica di un sito Web.

Il valore predefinito è false.
isDocFooterFileName Attributo booleano facoltativo.

Specifica se la stringa nell'attributo defaultDocFooter contiene un percorso di un file contenente il testo del piè di pagina predefinito per ogni pagina Web statica in un sito.

Il valore predefinito è false.

Elementi figlio

Elemento Descrizione
clientCache Elemento facoltativo.

Specifica le impostazioni per la memorizzazione nella cache di contenuto statico inviato al client.
mimeMap Elemento facoltativo.

Specifica un elenco delle estensioni del nome file per i mapping MIME.

Esempio di configurazione

Nell'esempio di configurazione seguente viene abilitato un piè di pagina del documento per il contenuto statico e viene aggiunto un semplice avviso di copyright come testo piè di pagina.

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

Codice di esempio

Gli esempi di codice seguenti consentono di abilitare un piè di pagina del documento per il contenuto statico e aggiungere un semplice avviso di copyright come testo piè di pagina.

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()