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

Статья
07/19/2023

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

Элемент <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()

Поделиться через