Статический контент <staticContent>

  • Статья

Общие сведения

Элемент <staticContent> настраивает несколько параметров, связанных с обработкой запросов для статических файлов в службах IIS 7.

Элемент <staticContent> содержит следующие три атрибута, которые указывают, следует ли IIS 7 применять нижний колонтитул документа к статическим файлам:

  • Атрибут enableDocFooter указывает, включены ли нижние колонтитулы документа.

  • Атрибут defaultDocFooter содержит:

    • Текстовая строка, которую IIS 7 будет использовать для нижнего колонтитула документа, если атрибут isDocFooterFileName имеет значение false.
    • Полный путь к файлу, который содержит текст, который iis 7 будет использовать для нижнего колонтитула документа, если атрибут isDocFooterFileName имеет значение true.

  • Как отмечалось ранее, атрибут 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 по умолчанию.

Инструкции

Отсутствует пользовательский интерфейс для настройки <staticContent> элемента для IIS 7. Примеры настройки <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()