HTTP プロトコル設定 <httpProtocol>
- 概要
- 互換性
- セットアップ
- 方法
- 構成
- サンプル コード
※本ページに挿入されている画像をクリックすると、画像全体が別ウィンドウで表示されます。
概要
<httpProtocol>
要素では、HTTP キープアライブ接続と、インターネット インフォメーション サービス (IIS) 7.0 から Web クライアントに送信するカスタム応答およびリダイレクト応答ヘッダーを構成できます。
ブラウザーでは、通常、Web ページ全体をダウンロードするために複数の要求を行います。サーバーのパフォーマンスを向上させるために、多くの Web ブラウザーでは、サーバーがこれらの全要求時に接続を開いた状態を維持することを要求します。これは、HTTP キープアライブと呼ばれる機能です。HTTP キープアライブなしでは、グラフィックなどの複数の要素を持つページに多数の要求を行うブラウザーは、各要素に別個の接続を要求する可能性があります。こうした追加の要求と接続は余分なサーバー動作とリソースを必要とするため、サーバーの効率が低下します。また、追加接続により、特に低速な接続においては、ブラウザーが大幅に低速化して応答が遅くなります。
互換性
IIS 7.0 | IIS 6.0 | |
---|---|---|
注意 | <httpProtocol> は IIS 7.0 で新たに導入された要素です。 |
<httpProtocol> 要素の allowKeepAlive 属性は、IIS 6.0 の AllowKeepAlive メタベース プロパティに代わるものです。 |
セットアップ
<httpProtocol>
要素は、IIS 7.0 の既定のインストールに含まれています。
方法
Web サイトまたはアプリケーションの HTTP キープアライブを有効にする方法
タスク バーで [スタート] ボタンをクリックし、[管理ツール] をポイントして [インターネット インフォメーション サービス (IIS) マネージャー] をクリックします。
[接続] ウィンドウで、HTTP キープアライブを有効にするサイト、アプリケーション、またはディレクトリに移動します。
[ホーム] ウィンドウで [HTTP 応答ヘッダー] をダブルクリックします。
[HTTP 応答ヘッダー] ページで、[操作] ウィンドウの [共通ヘッダーの設定] をクリックします。
[共通 HTTP 応答ヘッダーの設定] ダイアログ ボックスで、HTTP キープアライブを有効にするボックスをオンにし、[OK] をクリックします。
構成
属性
属性 | 説明 |
---|---|
allowKeepAlive |
オプションの Boolean 属性。 キープアライブ処理を許可する (true) かしないか (false) を指定します。 既定値は true です。 |
子要素
要素 | 説明 |
---|---|
customHeaders |
Web サーバーからの応答で返されるカスタム応答ヘッダーを構成します。 |
redirectHeaders |
Web サーバーが要求をリダイレクトする場合に限り、応答で返される応答ヘッダーを構成します。 |
構成サンプル
次のコード サンプルでは、Default Web Site に対して HTTP キーブアライブを有効にします。
<configuration>
<system.webServer>
<httpProtocol allowKeepAlive="true" />
</system.webServer>
</configuration>
注 : IIS 7.0 の ApplicationHost.config ファイルでは、次の既定の <httpProtocol>
要素が構成されています。
<httpProtocol>
<customHeaders>
<clear />
<add name="X-Powered-By" value="ASP.NET" />
</customHeaders>
<redirectHeaders>
<clear />
</redirectHeaders>
</httpProtocol>
サンプル コード
次のコード サンプルでは、Default Web Site に対して HTTP キーブアライブを有効にします。
AppCmd.exe
appcmd.exe set config "Default Web Site" -section:system.webServer/httpProtocol /allowKeepAlive:"True"
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 httpProtocolSection = config.GetSection("system.webServer/httpProtocol");
httpProtocolSection["allowKeepAlive"] = 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 httpProtocolSection As ConfigurationSection = config.GetSection("system.webServer/httpProtocol")
httpProtocolSection("allowKeepAlive") = True
serverManager.CommitChanges()
End Sub
End Module
JavaScript
var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST/Default Web Site";
var httpProtocolSection = adminManager.GetAdminSection("system.webServer/httpProtocol", "MACHINE/WEBROOT/APPHOST/Default Web Site");
httpProtocolSection.Properties.Item("allowKeepAlive").Value = true;
adminManager.CommitChanges();
VBScript
Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST/Default Web Site"
Set httpProtocolSection = adminManager.GetAdminSection("system.webServer/httpProtocol", "MACHINE/WEBROOT/APPHOST/Default Web Site")
httpProtocolSection.Properties.Item("allowKeepAlive").Value = True
adminManager.CommitChanges()