静的コンテンツ <staticContent>

概要

<staticContent> 要素は、インターネット インフォメーション サービス (IIS) 7 の静的ファイルの要求の処理に関連するいくつかの設定を構成します。

<staticContent> 要素には、IIS 7 で静的ファイルにドキュメント フッターを適用するかどうかを指定する次の 3 つの属性が含まれます。

• enableDocFooter 属性は、ドキュメント フッターを有効にするかどうかを指定します。

• defaultDocFooter 属性には、次のいずれかが含まれます。

  • isDocFooterFileName 属性が false に設定されている場合に、IIS 7 がドキュメント フッターに使用するテキスト文字列
  • isDocFooterFileName 属性が true に設定されている場合に、IIS 7 がドキュメント フッターに使用するテキストを含むファイルへの完全修飾パス。

• 前述のように、isDocFooterFileName 属性は、IIS 7 がドキュメント フッターに使用するテキスト文字列を defaultDocFooter 属性に含めるか、IIS 7 がドキュメント フッターに使用するテキストを含むファイルへの完全修飾パスを含めるかを指定します。

Note

既定では、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	省略可能な文字列属性。 サイト上のすべての Web ページの既定のフッター テキスト、または既定のフッター テキストを含むファイルのパスを指定します。 IIS 7 でこのプロパティを使用する方法は、isDocFooterFileName 属性の値によって異なります。 注意: カスタム フッターは、enableDocFooter 属性が true に設定されている場合にのみ送信されます。
enableDocFooter	省略可能な Boolean 属性です。 defaultDocFooter 属性で示されるテキストを Web サイト上のすべての静的ページに表示するかどうかを指定します。 既定値は false です。
isDocFooterFileName	省略可能な Boolean 属性です。 defaultDocFooter 属性の文字列に、サイト上のすべての静的 Web ページの既定のフッター テキストを含むファイルのパスを含めるかどうかを指定します。 既定値は 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()