Statischer Inhalt <staticContent>

  • Artikel

Übersicht

Das Element <staticContent> konfiguriert mehrere Einstellungen im Zusammenhang mit der Verarbeitung von Anforderungen für statische Dateien in Internetinformationsdienste (IIS) 7.

Das Element <staticContent> enthält die folgenden drei Attribute, die angeben, ob IIS 7 eine Dokumentfußzeile auf statische Dateien anwenden soll:

  • Das Attribut enableDocFooter gibt an, ob Dokumentfußzeilen aktiviert sind.

  • Das Attribut defaultDocFooter enthält eine der folgenden:

    • Eine Textzeichenfolge, die IIS 7 für die Dokumentfußzeile verwendet, wenn das Attribut isDocFooterFileName auf false gesetzt ist
    • Der vollqualifizierte Pfad zu einer Datei, die den Text enthält, den IIS 7 für die Dokumentfußzeile verwendet, wenn das Attribut isDocFooterFileName auf true gesetzt ist.

  • Wie oben erwähnt, gibt das Attribut isDocFooterFileName an, ob das Attribut defaultDocFooter eine Textzeichenfolge enthält, die IIS 7 für die Dokumentfußzeile oder den vollqualifizierten Pfad zu einer Datei verwendet, die den Text enthält, den IIS 7 für die Dokumentfußzeile verwendet.

Hinweis

Standardmäßig ist das Attribut isDocFooterFileName auf false gesetzt und global gesperrt. Um Dateien für Dokumentfußzeilen zu verwenden, müssen Sie entweder das Attribut isDocFooterFileName auf true auf globaler Ebene festlegen oder das Attribut entsperren. Weitere Informationen zum Sperren und Entsperren von Attributen finden Sie in der exemplarischen Vorgehensweise zu Verwenden der Sperre in IIS 7.0-Konfiguration.

Kompatibilität

Version Hinweise
IIS 10.0 Das <staticContent> Element wurde in IIS 10.0 nicht geändert.
IIS 8.5 Das <staticContent> Element wurde in IIS 8.5 nicht geändert.
IIS 8.0 Das <staticContent> Element wurde in IIS 8.0 nicht geändert.
IIS 7.5 Das <staticContent> Element wurde in IIS 7.5 nicht geändert.
IIS 7.0 Das <staticContent> Element wurde in IIS 7.0 eingeführt.
IIS 6.0 Das Element <staticContent> ersetzt die folgenden IIS 6.0-Metabasiseigenschaften:
  • DefaultDocFooter
  • EnableDocFooter

Setup

Das <staticContent>-Element ist in der Standardinstallation von IIS 7 enthalten.

Gewusst wie

Es gibt keine Benutzeroberfläche zum Konfigurieren des <staticContent>-Elements für IIS 7. Beispiele zum programmgesteuerten Konfigurieren des <staticContent>-Elements finden Sie im Abschnitt Codebeispiele dieses Dokuments.

Konfiguration

Attribute

Attribut Beschreibung
defaultDocFooter Optionales Zeichenfolgeattribut.

Gibt entweder den Standardfußzeilentext für jede Webseite auf einer Site oder den Pfad einer Datei an, die den Standardfußzeilentext enthält. Wie IIS 7 diese Eigenschaft verwendet, hängt vom Wert des Attributs isDocFooterFileName ab.

Hinweis: Die benutzerdefinierte Fußzeile wird nur gesendet, wenn das Attribut enableDocFooter auf true gesetzt ist.
enableDocFooter Optionales boolesches Attribut.

Gibt an, ob der durch das Attribut defaultDocFooter angegebene Text auf jeder statischen Seite auf einer Website angezeigt wird.

Der Standardwert ist false.
isDocFooterFileName Optionales boolesches Attribut.

Gibt an, ob die Zeichenfolge im Attribut defaultDocFooter einen Pfad einer Datei enthält, die den Standardfußzeilentext für jede statische Webseite auf einer Site enthält.

Der Standardwert ist false.

Untergeordnete Elemente

Element Beschreibung
clientCache Optionales Element.

Gibt Einstellungen für das Zwischenspeichern statischer Inhalte an, die an den Client gesendet werden.
mimeMap Optionales Element.

Gibt eine Liste der Dateinamenerweiterungen für MIME-Zuordnungen an.

Konfigurationsbeispiel

Im folgenden Konfigurationsbeispiel wird eine Dokumentfußzeile für statische Inhalte aktiviert und ein einfacher Copyright-Hinweis als Fußzeilentext hinzugefügt.

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

Beispielcode

Die folgenden Codebeispiele ermöglichen eine Dokumentfußzeile für statische Inhalte und fügen einen einfachen Copyright-Hinweis als Fußzeilentext hinzu.

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