静态内容 <staticContent>

概述

概述 <staticContent> 元素配置与 Internet Information Services (IIS) 7 中的静态文件处理请求相关的多个设置。

<staticContent> 元素包含以下三个属性,用于指定 IIS 7 是否应将文档页脚应用于静态文件:

  • enableDocFooter 属性指定是否启用文档页脚。

  • defaultDocFooter 属性包含以下任一一项:

    • 如果 isDocFooterFileName 属性设置为 false,IIS 7 将用作文档页脚的文本字符串
    • 如果 isDocFooterFileName 属性设置为 true,IIS 7 将用作文档页脚的文本所在文件的完全限定路径。
  • 如上所述,isDocFooterFileName 属性指定 defaultDocFooter 属性是否包含 IIS 7 将用作文档页脚的文本字符串或包含 IIS 7 将用作文档页脚的文本所在文件的完全限定路径。

注意

默认情况下,isDocFooterFileName 属性设置为 false 并全局锁定。 若要对文档页脚使用文件,需要在全局级别将 isDocFooterFileName 属性设置为 true,或解锁属性。 若要了解有关锁定和解锁属性的详细信息,请参阅如何在 IIS 7.0 配置中使用锁定演练。

兼容性

版本 说明
IIS 10.0 <staticContent> 元素在 IIS 10.0 中未进行修改。
IIS 8.5 <staticContent> 元素在 IIS 8.5 中未进行修改。
IIS 8.0 <staticContent> 元素在 IIS 8.0 中未进行修改。
IIS 7.5 <staticContent> 元素未在 IIS 7.5 中进行修改。
IIS 7.0 <staticContent> 元素是在 IIS 7.0 中引入的。
IIS 6.0 <staticContent> 元素替换以下 IIS 6.0 元数据库属性:
  • DefaultDocFooter
  • EnableDocFooter

安装

<staticContent> 元素包含在 IIS 7 的默认安装中。

操作方式

IIS 7 中没有用于配置 <staticContent> 元素的用户界面。 若要通过示例来了解如何以编程方式配置 <staticContent> 元素,请参阅本文档的代码示例部分。

配置

特性

属性 说明
defaultDocFooter 可选的字符串属性。

指定站点上每个网页的默认页脚文本,或某个文件(其中包含默认页脚文本)的路径。 IIS 7 如何使用此属性取决于 isDocFooterFileName 属性的值。

注意:仅当 enableDocFooter 属性设置为 true 时,才会发送自定义页脚。
enableDocFooter 可选布尔属性。

指定 defaultDocFooter 属性指示的文本是否将显示在站点上的每个静态页面上。

默认值为 false
isDocFooterFileName 可选布尔属性。

指定 defaultDocFooter 字符串是否包含文件的路径,该文件包含站点上每个静态网页的默认页脚文本。

默认值为 false

子元素

元素 说明
clientCache 可选元素。

指定用于缓存发送到客户端的静态内容的设置。
mimeMap 可选元素。

指定 MIME 映射的文件扩展名列表。

配置示例

以下配置示例为静态内容启用文档页脚,并添加一个简单的版权声明作为页脚文本。

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

代码示例

以下配置代码示例为静态内容启用文档页脚,并添加一个简单的版权声明作为页脚文本。

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