さまざまなバージョンの IIS と共に ASP.NET MVC を使用する (VB)

[アーティクル]
04/21/2024

このチュートリアルでは、ASP.NET MVC と URL ルーティングをさまざまなバージョンのインターネットインフォメーションサービスと連携させる方法について説明します。 IIS 7.0 (クラシックモード)、IIS 6.0 および以前のバージョンの IIS で ASP.NET MVC を使用するためのさまざまな方法について説明します。

ASP.NET MVC フレームワークは、ブラウザー要求をコントローラーアクションにルーティングする ASP.NET ルーティングに依存します。 ASP.NET ルーティングを利用するには、Web サーバーで追加の構成手順を実行する必要がある場合があります。これはすべて、インターネットインフォメーションサービス (IIS) のバージョンとアプリケーションの要求処理モードによって異なります。

IIS のさまざまなバージョンの概要を次に示します。

IIS 7.0 (統合モード) - ASP.NET ルーティングを使用するために特別な構成は必要ありません。
IIS 7.0 (クラシックモード) - ASP.NET ルーティングを使用するには、特別な構成を実行する必要があります。
IIS 6.0 以前のバージョン - ASP.NET ルーティングを使用するには、特別な構成を実行する必要があります。

IIS の最新バージョンはバージョン 7.5 (Win7 の場合) です。 IIS の IIS 7 は、Windows Server 2008 および VISTA/SP1 以降に含まれています。また、Home Basic を除く Vista オペレーティングシステムの任意のバージョンに IIS 7.0 をインストールすることもできます (https://technet.microsoft.com/library/cc731179%28WS.10%29.aspx を参照)。

IIS 7.0 では、要求を処理するための 2 つのモードがサポートされています。統合モードまたはクラシックモードを使用することができます。 IIS 7.0 を統合モードで使用する場合は、特別な構成手順を実行する必要はありません。ただし、IIS 7.0 をクラシックモードで使用する場合は、追加の構成を実行する必要があります。

Microsoft Windows Server 2003 には IIS 6.0 が含まれています。 Windows Server 2003 オペレーティングシステムを使用する場合、IIS 6.0 を IIS 7.0 にアップグレードすることはできません。 IIS 6.0 を使用する場合は、追加の構成手順を実行する必要があります。

Microsoft Windows XP Professional には IIS 5.1 が含まれています。 IIS 5.1 を使用する場合は、追加の構成手順を実行する必要があります。

最後に、Microsoft Windows 2000 と Microsoft Windows 2000 Professional には IIS 5.0 が含まれています。 IIS 5.0 を使用する場合は、追加の構成手順を実行する必要があります。

統合モードとクラシックモード

IIS 7.0 では、次の 2 つの要求処理モードを使用して要求を処理できます: 統合、クラシック。統合モードでは、パフォーマンスが向上し、より多くの機能が提供されます。クラシックモードは、以前のバージョンの IIS との下位互換性があります。

要求処理モードは、アプリケーションプールによって決定されます。アプリケーションに関連付けられているアプリケーションプールを決定することで、特定の Web アプリケーションによって使用されている処理モードを判断できます。次のステップを実行します。

インターネットインフォメーションサービスマネージャを起動します
[接続] ウィンドウで、アプリケーションを選択します
[アクション] ウィンドウで、[基本設定] リンクをクリックして [アプリケーションの編集] ダイアログボックスを開きます (図 1 を参照)
選択したアプリケーションプールを書き留めます。

既定では、IIS は、DefaultAppPool と Classic .NET AppPool の 2 つのアプリケーションプールをサポートするように構成されています。 DefaultAppPool が選択されている場合、アプリケーションは統合された要求処理モードで実行されます。 Classic .NET AppPool が選択されている場合、アプリケーションはクラシック要求処理モードで実行されます。

図 1: 要求処理モードの検出 (クリックするとフルサイズの画像が表示されます)

[アプリケーションの編集] ダイアログボックス内で要求処理モードを変更できることに注意してください。 [選択] ボタンをクリックし、アプリケーションに関連付けられているアプリケーションプールを変更します。 ASP.NET アプリケーションをクラシックモードから統合モードに変更するときに、互換性の問題があることに注意してください。詳細については、次の記事をご覧ください。

Windows Vista および Windows Server 2008 での ASP.NET 1.1 から IIS 7.0 へのアップグレード -- https://www.iis.net/learn/application-frameworks/building-and-running-aspnet-applications/upgrading-aspnet-11-to-iis-on-windows-vista-and-windows-server-2008
ASP.NET の IIS 7.0 との統合 - https://www.iis.net/learn/application-frameworks/building-and-running-aspnet-applications/aspnet-integration-with-iis

ASP.NET アプリケーションで DefaultAppPool を使用している場合は、ASP.NET ルーティング (したがって MVC ASP.NET) を動作させるために追加の手順を実行する必要はありません。ただし、ASP.NET アプリケーションが Classic .NET AppPool を使用するように構成されている場合は、追加の手順が必要です。引き続き、読み続けてください。

以前のバージョンの IIS で ASP.NET MVC を使用する

IIS 7.0 より古いバージョンの IIS で ASP.NET MVC を使用する必要がある場合、またはクラシックモードで IIS 7.0 を使用する必要がある場合は、2 つのオプションがあります。 1 つ目として、ファイル拡張子を使用するようにルートテーブルを変更できます。たとえば、/Store/Details などの URL を要求する代わりに、/Store.aspx/Details などの URL を要求します。

2 つ目のオプションとして、"ワイルドカードスクリプトマップ" というものを作成します。ワイルドカードスクリプトマップを使用すると、すべての要求を ASP.NET フレームワークにマップできます。

Web サーバーにアクセスできない場合 (たとえば、ASP.NET MVC アプリケーションがインターネットサービスプロバイダーによってホストされている場合など) は、最初のオプションを使用する必要があります。 URL の表示方法を変更する必要がなく、Web サーバーにアクセスできる場合は、2 番目のオプションを使用できます。

以降のセクションでは、各オプションについて詳しく説明します。

ルートテーブルに拡張子を追加する

ASP.NET ルーティングを古いバージョンの IIS と連携させる最も簡単な方法は、Global.asax ファイル内のルートテーブルを変更することです。リスト 1 の既定の Global.asax ファイルと未変更の Global.asax ファイルは、"既定のルート" という名前の 1 つのルートを構成します。

リスト 1 - Global.asax (変更されない)

Public Class MvcApplication

        Inherits System.Web.HttpApplication 

        Shared Sub RegisterRoutes(ByVal routes As RouteCollection)

            routes.IgnoreRoute("{resource}.axd/{*pathInfo}") 

            ' MapRoute takes the following parameters, in order:

            ' (1) Route name

            ' (2) URL with parameters

            ' (3) Parameter defaults

            routes.MapRoute( _

                "Default", _

                "{controller}/{action}/{id}", _

                New With {.controller = "Home", .action = "Index", .id = ""} _

            ) 

        End Sub 

        Sub Application_Start()

            RegisterRoutes(RouteTable.Routes)

        End Sub

    End Class

リスト 1 で構成された既定のルートを使用すると、次のような URL をルーティングできます。

/Home/Index

/Product/Details/3

/Product

残念ながら、古いバージョンの IIS は、これらの要求を ASP.NET フレームワークに渡しません。そのため、これらの要求はコントローラーにルーティングされません。たとえば、URL /Home/Index に対してブラウザー要求を行うと、図 2 のエラーページが表示されます。

図 2: 404 見つかりませんエラーの受信 (クリックするとフルサイズの画像が表示されます)

古いバージョンの IIS では、特定の要求のみが ASP.NET フレームワークにマップされます。要求は、適切なファイル拡張子を持つ URL 用である必要があります。たとえば、/SomePage.aspx の要求は、ASP.NET フレームワークにマップされますが、 /SomePage.htm の要求はそうではありません。

そのため、ASP.NET ルーティングを機能させるには、既定のルートを変更して、ASP.NET フレームワークにマップされているファイル拡張子が含まれるようにする必要があります。

これは、registermvc.wsf という名前のスクリプトを使用して行われます。これは、ASP.NET MVC 1 リリースで C:\Program Files\Microsoft ASP.NET\ASP.NET MVC\Scripts に含まれていましたが、ASP.NET 2 の時点で、このスクリプトは ASP.NET Futures に移行されました。

このスクリプトを実行すると、新しい .mvc 拡張子が IIS に登録されます。 .mvc 拡張子を登録したら、Global.asax ファイル内のルートを変更して、ルートで .mvc 拡張子が使用されるようにすることができます。

リスト 2 で変更された Global.asax ファイルは、古いバージョンの IIS で動作します。

リスト 2 - Global.asax (拡張子の変更)

Public Class MvcApplication

        Inherits System.Web.HttpApplication 

        Shared Sub RegisterRoutes(ByVal routes As RouteCollection)

            routes.IgnoreRoute("{resource}.axd/{*pathInfo}") 

            ' MapRoute takes the following parameters, in order:

            ' (1) Route name

            ' (2) URL with parameters

            ' (3) Parameter defaults

            routes.MapRoute( _

                "Default", _

                "{controller}.mvc/{action}/{id}", _

                New With {.controller = "Home", .action = "Index", .id = ""} _

            ) 

            routes.MapRoute( _

                "Root", _

                "", _

                New With {.controller = "Home", .action = "Index", .id = ""} _

            ) 

        End Sub 

        Sub Application_Start()

            RegisterRoutes(RouteTable.Routes)

        End Sub

    End Class

重要: Global.asax ファイルを変更した後、ASP.NET MVC アプリケーションをもう一度ビルドすることを忘れないでください。

リスト 2 の Global.asax ファイルには、2 つの重要な変更点があります。 Global.asax に 2 つのルートが定義されるようになりました。既定のルート (最初のルート) の URL パターンは次のようになります。

{controller}.mvc/{action}/{id}

.mvc 拡張子を追加すると、ASP.NET ルーティングモジュールがインターセプトするファイルの種類が変更されます。この変更により、ASP.NET MVC アプリケーションは次のような要求をルーティングするようになりました。

/Home.mvc/Index/

/Product.mvc/Details/3

/Product.mvc/

2 番目のルート (Root ルート) は、新しいルートです。 Root ルートのこの URL パターンは、空の文字列です。このルートは、アプリケーションのルートに対して行われた要求を照合するために必要です。たとえば、Root ルートは、次のような要求と一致します。

http://www.YourApplication.com/

ルートテーブルにこれらの変更を加えた後、アプリケーション内のすべてのリンクがこれらの新しい URL パターンと互換性があることを確認する必要があります。つまり、すべてのリンクに .mvc 拡張子が含まれていることを確認します。 Html.ActionLink() ヘルパーメソッドを使用してリンクを生成する場合は、変更を加える必要はありません。

registermvc.wcf スクリプトを使用する代わりに、手動で新しい拡張子を、ASP.NET フレームワークにマップされている IIS に追加できます。新しい拡張子を自分で追加するときは、[ファイルの存在を確認する] というラベルのチェックボックスがオフになっていることを確認します。

ホストされたサーバー

常に Web サーバーにアクセスできるとは限りません。たとえば、インターネットホスティングプロバイダーを使用して ASP.NET MVC アプリケーションをホストしている場合、必ずしも IIS にアクセスできるわけではありません。

その場合は、ASP.NET フレームワークにマップされている既存のファイル拡張子のいずれかを使用する必要があります。 ASP.NET にマップされるファイル拡張子の例には、.aspx、.axd、.ashx などがあります。

たとえば、リスト 3 で変更された Global.asax ファイルでは、.mvc 拡張子ではなく.aspx 拡張子が使用されます。

リスト 3 - Global.asax (.aspx 拡張子に変更)

Public Class MvcApplication

        Inherits System.Web.HttpApplication 

        Shared Sub RegisterRoutes(ByVal routes As RouteCollection)

            routes.IgnoreRoute("{resource}.axd/{*pathInfo}") 

            ' MapRoute takes the following parameters, in order:

            ' (1) Route name

            ' (2) URL with parameters

            ' (3) Parameter defaults

            routes.MapRoute( _

                "Default", _

                "{controller}.aspx/{action}/{id}", _

                New With {.controller = "Home", .action = "Index", .id = ""} _

            ) 

            routes.MapRoute( _

                "Root", _

                "", _

                New With {.controller = "Home", .action = "Index", .id = ""} _

            ) 

        End Sub 

        Sub Application_Start()

            RegisterRoutes(RouteTable.Routes)

        End Sub

    End Class

リスト 3 の Global.asax ファイルは、.mvc 拡張子の代わりに .aspx 拡張子を使用する点を除き、前の Global.asax ファイルとまったく同じです。 .aspx 拡張子を使用するために、リモート Web サーバーでセットアップを実行する必要はありません。

ワイルドカードスクリプトマップを作成する

ASP.NET MVC アプリケーションの URL の変更を希望せず、Web サーバーにアクセスできる場合は、別のオプションがあります。 Web サーバーに対するすべての要求を ASP.NET フレームワークにマップする、ワイルドカードスクリプトマップを作成できます。ここでは、IIS 7.0 (クラシックモード) または IIS 6.0 で、既定の ASP.NET MVC ルートテーブルを使用できます。

このオプションにより、IIS は Web サーバーに対して行われたすべての要求をインターセプトすることに注意してください。これには、イメージ、従来の ASP ページ、および HTML ページの要求が含まれます。そのため、ASP.NET に対してワイルドカードスクリプトマップを有効にすると、パフォーマンスに影響します。

IIS 7.0 のワイルドカードスクリプトマップを有効にする方法を次に示します。

[接続] ウィンドウでアプリケーションを選択します
機能ビューが選択されていることを確認します
[ハンドラーマッピング] ボタンをダブルクリックします
[ワイルドカードスクリプトマップの追加] リンクをクリックします (図 3 を参照)
aspnet_isapi.dll ファイルへのパスを入力します (PageHandlerFactory スクリプトマップからこのパスをコピーできます)。
名前に「MVC」と入力します
[OK] ボタンをクリックします

図 3: IIS 7.0 でのワイルドカードスクリプトマップの作成 (クリックするとフルサイズの画像が表示されます)

IIS 6.0 でワイルドカードスクリプトマップを作成するには、次の手順に従います。

Web サイトを右クリックし、[プロパティ] を選択します
[ホームディレクトリ] タブを選択します
[構成] ボタンをクリックします
[マッピング] タブを選択します
[挿入] ボタンをクリックします (図 4 を参照)
aspnet_isapi.dll へのパスを [実行可能ファイル] フィールドに貼り付けます (このパスは、.aspx ファイルのスクリプトマップからコピーできます)
[ファイルの存在を確認する] というチェックボックスをオフにします
[OK] ボタンをクリックします

図 4: IIS 6.0 でのワイルドカードスクリプトマップの作成 (クリックするとフルサイズの画像が表示されます)

ワイルドカードスクリプトマップを有効にしたら、Global.asax ファイル内のルートテーブルを Root ルートを含めるように変更する必要があります。そうしないと、アプリケーションのルートページの要求を行ったときに、図 5 のエラーページが表示されます。変更された Global.asax ファイルをリスト 4 で使用できます。

図 5: Root ルートの不足エラー (クリックするとフルサイズの画像が表示されます)

リスト 4 - Global.asax (Root ルートの変更)

Public Class MvcApplication

        Inherits System.Web.HttpApplication 

        Shared Sub RegisterRoutes(ByVal routes As RouteCollection)

            routes.IgnoreRoute("{resource}.axd/{*pathInfo}") 

            ' MapRoute takes the following parameters, in order:

            ' (1) Route name

            ' (2) URL with parameters

            ' (3) Parameter defaults

            routes.MapRoute( _

                "Default", _

                "{controller}/{action}/{id}", _

                New With {.controller = "Home", .action = "Index", .id = ""} _

            ) 

            routes.MapRoute( _

                "Root", _

                "", _

                New With {.controller = "Home", .action = "Index", .id = ""} _

            ) 

        End Sub 

        Sub Application_Start()

            RegisterRoutes(RouteTable.Routes)

        End Sub

    End Class

IIS 7.0 または IIS 6.0 用にワイルドカードスクリプトマップを有効にすると、次のような既定のルートテーブルで機能する要求を行うことができます。

/Home/Index

/Product/Details/3

/Product

まとめ

このチュートリアルでは、古いバージョンの IIS (またはクラシックモードの IIS 7.0) の使用時の ASP.NET MVC の使用方法について説明しました。 ASP.NET ルーティングを以前のバージョンの IIS で動作させる次の 2 つの方法 (既定のルートテーブルを変更するか、ワイルドカードスクリプトマップを作成する) を紹介しました。

最初のオプションでは、ASP.NET MVC アプリケーションで使用される URL を変更する必要があります。この最初のオプションの非常に大きな利点の 1 つは、ルートテーブルを変更するために Web サーバーにアクセスする必要がないということです。つまり、この最初のオプションは、インターネットホスティング会社が ASP.NET MVC アプリケーションをホストする場合でも、使用できます。

2 つ目のオプションは、ワイルドカードスクリプトマップの作成です。この 2 つ目のオプションの利点は、URL を変更する必要がないということです。この 2 番目のオプションの欠点は、ASP.NET MVC アプリケーションのパフォーマンスに影響を与える可能性があるということです。

次の方法で共有

さまざまなバージョンの IIS と共に ASP.NET MVC を使用する (VB)

統合モードとクラシックモード

以前のバージョンの IIS で ASP.NET MVC を使用する

ルートテーブルに拡張子を追加する

ホストされたサーバー

ワイルドカードスクリプトマップを作成する

まとめ

フィードバック

その他のリソース

次の方法で共有

さまざまなバージョンの IIS と共に ASP.NET MVC を使用する (VB)

統合モードとクラシック モード

以前のバージョンの IIS で ASP.NET MVC を使用する

ルート テーブルに拡張子を追加する

ホストされたサーバー

ワイルドカード スクリプト マップを作成する

まとめ

フィードバック

その他のリソース

統合モードとクラシックモード

ルートテーブルに拡張子を追加する

ワイルドカードスクリプトマップを作成する