更新 : 2007 年 11 月
このチュートリアルでは、Visual Studio .NET 2002 または Visual Studio .NET 2003 Web プロジェクトを Visual Studio 2008 Web アプリケーション プログラムに変換する方法について説明します。Visual Studio 2008 Web アプリケーション プロジェクト モデルは、Visual Studio 2005 Web アプリケーション プロジェクト モデルに似ています。したがって、変換プロセスも似ています。Web アプリケーション プロジェクトの詳細については、「Web アプリケーション プロジェクトの概要」を参照してください。
Visual Studio .NET Web プロジェクトから Visual Studio 2008 Web サイト プロジェクトに変換することもできます。ただし、Web アプリケーション プロジェクトへの変換の方がサポートされている方法であり、変換を支援する便利なツールも用意されています。たとえば、Visual Studio 2008 Web アプリケーション プロジェクトに変換する場合は、Visual Studio 変換ウィザードを使用してプロセスの一部を自動化できます。Visual Studio .NET Web プロジェクトを Visual Studio 2008 Web サイトに変換する方法の詳細については、「Common Web Project Conversion Issues and Solutions」を参照してください。
Visual Studio 2002 または 2003 Web プロジェクトから Visual Studio 2008 Web アプリケーション プロジェクトに変換する手順は、2 つの部分に分けられます。それぞれの部分は次のとおりです。
プロジェクトを変換する。プロジェクト ファイルと Web.config ファイルの最初の変換には、Visual Studio 変換ウィザードを使用できます。後で [Web アプリケーションに変換] を使用すると、プロジェクトのファイルと構造を更新できます。
プロジェクトの .NET Framework のバージョンをアップグレードする。プロジェクトの .NET Framework のバージョンを、.NET Framework 2.0 SP1 または .NET Framework 3.5 にアップグレードする必要があります。.NET Framework のバージョンのアップグレードが必要となる理由は、Visual Studio 2008 では、以前のバージョンの .NET Framework を対象にすることができないためです。このアップグレードは、変換ウィザードを使用してプロジェクトの変換中に実行できます。または、プロジェクトを変換した後で、.NET Framework のバージョンをアップグレードすることもできます。
.gif "メモ")
メモ :プロジェクトの .NET Framework のバージョンは手動で変更できます。そのためには、Visual Studio でプロジェクトのプロパティ ページを開き、[アプリケーション] タブをクリックして、[対象のフレームワーク] ボックスの一覧で新しいバージョンをクリックします。
このチュートリアルでは、次のタスクについて説明します。
Visual Studio 2008 で Visual Studio .NET プロジェクトを開き、プロジェクト ファイルのバックアップを作成する。
プロジェクトが対象とする .NET Framework のバージョンをアップグレードする。
プロジェクト ファイルと Web.config ファイルを変換する。
ASP.NET コード ファイルを変換する。
変換したプロジェクトをテストする。
前提条件
このチュートリアルを完了するための要件を次に示します。
Visual Studio 2008
エラーくコンパイルおよび実行される、Visual Studio .NET Version 2002 または 2003 で作成された Web サイト プロジェクト。
プロジェクトの変換と .NET Framework のバージョンのアップグレード
最初の手順として、Visual Studio 2008 でプロジェクトを開きます。これにより、変換が開始されます。このとき、プロジェクトの変換前にバックアップを作成できます。
| メモ : |
|---|
プロジェクトをバックアップすることを強くお勧めします。変換は元のプロジェクト ファイルで行われるため、変換に失敗すると復元できません。 |
プロジェクトを変換してファイルをバックアップするには
Visual Studio 2008 で、[ファイル] メニューの [開く] をクリックし、[プロジェクト] をクリックします。
[プロジェクトを開く] ダイアログ ボックスが表示されます。
Visual Studio .NET プロジェクトのプロジェクトまたはソリューション ファイルを含むフォルダを参照し、[開く] をクリックします。
メモ :プロジェクトを開くときは、必ず [プロジェクトを開く] を使用してください。[Web サイトを開く] を使用すると、プロジェクトが Web サイト プロジェクト形式に変換されます。
変換ウィザードが開き、プロジェクトを変換する前にバックアップを作成するように要求するメッセージが表示されます。
バックアップを作成するには、[はい] をクリックします。
[参照] をクリックし、バックアップを作成するフォルダを選択して [次へ] をクリックします。
[完了] をクリックします。
バックアップが開始されます。
メモ :変換ウィザードでのファイルのコピー中に、更新や進行状況が表示されないまま、大幅な遅延が発生する場合があります。処理が完了するのを待ってから、続行してください。
変換が完了すると、プロジェクトの対象となっている .NET Framework のバージョンをアップグレードするように要求するメッセージが表示されます。
.NET Framework 3.5 にアップグレードするには、[はい] をクリックします。.NET Framework 2.0 SP1 を対象とするようにプロジェクトをアップグレードするには、[いいえ] をクリックします。
ソリューション内のすべての Web をアップグレードするかどうかを確認するチェック ボックスは、オンのままにしておくことをお勧めします。
.NET Framework 3.5 にアップグレードすると、プロジェクト ファイルと同時にプロジェクトの Web.config ファイルが変更されます。
アップグレードと変換が完了すると、プロジェクトの変換の最初の手順が完了したことを示すメッセージが表示されます。
[OK] をクリックします。
変換に関するステータス情報が表示されます。
[閉じる] をクリックします。
変換したプロジェクトのテスト
変換が完了したら、プロジェクトをテストして、プロジェクトを実行できるかどうかを確認できます。これは、更新する必要のあるプロジェクトのコードを特定するためにも役立ちます。
プロジェクトの実行を確認するには
.NET Framework の新しいバージョンでコードを実行するために必要な変更がわかっている場合は、それらの変更を行います。
[ビルド] メニューの [ビルド] をクリックします。
プロジェクト内の不明な参照やその他のコンパイル エラーがすべて、[エラー一覧] ウィンドウに表示されます。よく発生する問題として、アセンブリ参照の欠落や、動的に生成された型の問題があります。
ソリューション エクスプローラで、アプリケーションの起動に使用する Web ページを右クリックし、[スタート ページに設定] をクリックします。
[デバッグ] メニューの [デバッグ開始] をクリックします。
デバッグが有効になっていない場合、[デバッグが無効です] ダイアログ ボックスが表示されます。デバッグを有効にした Web.config ファイルを追加するオプションを選択し、[OK] をクリックします。
変換されたプロジェクトが問題なく実行されることを確認します。
ビルド エラーとランタイム エラーがすべて解決されるまでは、変換プロセスを続行しないでください。
ASP.NET コード ファイルの変換
分離コード モデルを使用する Visual Studio 2008 の ASP.NET Web ページ ファイルとユーザー コントロール ファイルは、デザイナ ファイルに関連付けられています。変換したファイルは、分離コード ファイルには関連付けられますが、デザイナ ファイルはありません。そのため、次の手順ではデザイナ ファイルを生成します。
| メモ : |
|---|
個別のデザイナ ファイルが必要となるのは、個別のコード ファイルのコードを使用する ASP.NET Web ページとユーザー コントロールだけです。インライン コードを使用し、コード ファイルに関連付けられていないページの場合、デザイナ ファイルは生成されません。 |
ASP.NET コード ファイルを変換するには
ソリューション エクスプローラでプロジェクト ノードを右クリックし、[Web アプリケーションに変換] をクリックします。
ファイルが変換されます。
変換されたコード ファイルに、コード ファイルとデザイナ ファイルが含まれていることを確認します。
プロジェクトをビルドして実行し、変換の結果を確認します。
参照
概念
概要 : Visual Studio の Web サイトおよびプロジェクトの Visual Studio 2008 の Web サイトおよびプロジェクトへの変換