静的コンテンツ <staticContent>
- 概要
- 互換性
- セットアップ
- 方法
- 構成
- サンプル コード
概要
<staticContent>
要素は、インターネット インフォメーション サービス (IIS) 7.0 の静的ファイルに対する要求の処理に関連するいくつかの設定を構成します。
<staticContent>
要素には、IIS 7.0 で静的ファイルにドキュメント フッターを適用するかどうかを指定する、次の 3 つの属性が含まれます。
- enableDocFooter 属性は、ドキュメント フッターを有効にするかどうかを指定します。
- defaultDocFooter 属性には、次のいずれかが含まれます。
- isDocFooterFileName 属性が false に設定されている場合、IIS 7.0 でドキュメント フッターに使用するテキスト文字列
- isDocFooterFileName 属性が true に設定されている場合、IIS 7.0 でドキュメント フッターに使用するテキストを含むファイルへの完全修飾パス
- 上記のとおり、isDocFooterFileName 属性は、defaultDocFooter 属性にドキュメント フッターに使用するテキスト文字列が含まれるか、ドキュメント フッターに使用するテキストを含むファイルへの完全修飾パスが含まれるかを指定します。
注 : 既定では、isDocFooterFileName 属性は false に設定され、グローバルにロックされています。ドキュメント フッターでファイルを使用するには、グローバル レベルで isDocFooterFileName 属性を true に設定するか、属性のロックを解除する必要があります。属性のロックおよびロック解除の詳細については、「IIS 7.0 構成でロックを使用する方法」のチュートリアルを参照してください。
互換性
IIS 7.0 | IIS 6.0 | |
---|---|---|
説明 | <staticContent> は IIS 7.0 で新たに導入された要素です。 |
<staticContent> 要素は、IIS 6.0 の次のメタベース プロパティに代わるものです。DefaultDocFooter EnableDocFooter |
セットアップ
<staticContent>
要素は、IIS 7.0 の既定のインストールに含まれています。
方法
IIS 7.0 には、<staticContent>
要素を構成するためのユーザー インターフェイスはありません。<staticContent>
要素をプログラムを使用して構成する方法の例については、このドキュメントの「サンプル コード」セクションを参照してください。
構成
属性
属性 | 説明 |
---|---|
defaultDocFooter |
オプションの string 属性。 サイト上のすべての Web ページの既定のフッター テキスト、または既定のフッター テキストを含むファイルのパスを指定します。このプロパティの使用方法は、isDocFooterFileName 属性の値によって異なります。 注 : カスタム フッターは、enableDocFooter 属性が true に設定されている場合にのみ送信されます。 |
enableDocFooter |
オプションの Boolean 属性。 Web サイトのすべての静的ページで、defaultDocFooter 属性で指定されたテキストを表示するかどうかを指定します。 既定値は 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()