プロジェクト管理

Visual Studio Code で C# アプリケーションを作成する際は、プロジェクトから始めます。プロジェクトには、実行可能ファイル、ライブラリ、またはウェブサイトにコンパイルされるすべてのファイル (ソースコード、画像など) が含まれています。関連するすべてのプロジェクトは、**ソリューション**と呼ばれるコンテナーに格納できます。この記事では、ソリューションエクスプローラービューを介して、すべてのプロジェクトとそのファイルを管理する方法について説明します。

注: VS Code でソリューションエクスプローラービューを使用するには、C# Dev Kit 拡張機能が必要です。

ソリューションエクスプローラー

新しい C# Dev Kit 拡張機能には、プライマリサイドバーに新しいビューであるソリューションエクスプローラーが含まれています。このビューは、アプリケーション、そのソリューション、およびプロジェクトの構造化されたビューを提供し、楽な中央集約型のプロジェクト管理を可能にします。.NET ソリューションファイルまたはプロジェクトファイルを含むワークスペースを開くと、ソリューションエクスプローラーが自動的に表示されます。

ヒント: エクスプローラーペインにソリューションエクスプローラーセクションが表示されていない場合、手動で有効にできます。エクスプローラービューを開き、エクスプローラーのタイトルバーにあるビューとその他のアクション (...) ボタンを選択し、ソリューションエクスプローラーをチェックしてオンにします。アクティビティバーを右クリックしても、この特定のビューは制御されないことに注意してください。

ワークスペースに単一のソリューションファイル (.sln ファイル) がある場合、ソリューションエクスプローラーはそのファイルを検出し、ワークスペースがロードされた後に自動的にロードします。例えば、単一のソリューションファイルを含むワークスペースを開くエクスペリエンスを示す以下の動画をご覧ください。

上記の動画では、ワークスペースが初めて VS Code にロードされました。ワークスペースがロードされると、ソリューションエクスプローラーは単一の .sln ファイルを検出し、それを自動的にロードします。

ワークスペースに複数のソリューションファイルがある場合、ロードする特定のソリューションファイルを選択するよう求められます。ワークスペースにソリューションファイルがロードされると、拡張機能は最後にロードされたソリューションファイルを記憶し、VS Code でワークスペースがロードされるときにそのファイルを自動的に再ロードします。以下の動画では、複数のソリューションファイルを含むワークスペースを初めて開くエクスペリエンスを見ることができます。

上記の動画では、ワークスペースがロードされた後、ソリューションエクスプローラーはワークスペースに複数のソリューションファイルが含まれていることを検出し、標準の VS Code 通知でロードするソリューションを選択するよう求められます。今後同じワークスペースを開く際には、ソリューションエクスプローラーは最後にロードされたソリューションファイルを記憶し、それを自動的に再ロードします。

ソリューションエクスプローラーにソリューションがロードされており、そのソリューションを閉じたい場合は、ソリューションを閉じるコマンドを使用できます。このコマンドは、ソリューションエクスプローラーでソリューションを右クリックしたときに表示されるコンテキストメニューにあります。

このコマンドはコマンドパレットからも実行できます。コマンドパレットは ⇧⌘P (Windows, Linux Ctrl+Shift+P) で開くことができます。これは次の画像に示されています。

ソリューションを閉じた後、ソリューションエクスプローラーには、後でワークスペースからソリューションファイルを開くためのボタンが表示されます。また、コマンドパレットから**.NET: Open Solution**コマンドでそのコマンドを実行することもできます。

ソリューションを開くコマンドを実行すると、ワークスペースに単一のソリューションファイルがある場合は、それが自動的にロードされます。複数のソリューションファイルがある場合は、ロードするソリューションファイルを選択するよう求められます。これは、1つまたは複数のソリューションファイルを含むワークスペースを初めて開く場合と同じエクスペリエンスです。次に、ソリューションエクスプローラーでのソリューションフォルダーのサポートについて説明しましょう。

ソリューションフォルダー

ソリューションエクスプローラーでは、ソリューションにソリューションフォルダー（ソリューション内でプロジェクトをグループ化するために使用される仮想フォルダー）が含まれている場合、それらが表示されます。ここでは、ソリューションフォルダーの内容を操作できます。新しいソリューションフォルダーを追加するには、ソリューションを右クリックし、新しいソリューションフォルダーメニュー項目を選択します。以下の短い動画をご覧ください。

上記の動画では、「tests」という名前の新しいソリューションフォルダーが作成されました。ソリューションフォルダーを作成した後、既存のプロジェクトを追加コンテキストメニューを使用して、プロジェクトを追加できます。以下の動画はこのエクスペリエンスを示しています。

以下の画像に示す新しいファイルの追加コンテキストメニューを使用して、ソリューションフォルダーに新しいファイルを追加することもできます。

このコマンドを実行すると、コマンドパレットで使用するファイルテンプレートを選択するよう求められます。以下の画像にこれを示します。

このリストは、拡張機能が現在ソリューションフォルダーでサポートしているファイルテンプレートを示しています。テンプレートを使用せずにファイルを作成するには（空白ファイルを作成するには）、カスタムファイル (テンプレートなし)を選択します。

ソリューションフォルダーを削除するには、削除コンテキストメニューオプションを使用できます。

ソリューションからソリューションフォルダーを削除すると、ソリューションフォルダーとその内容はソリューションから削除されます。それに含まれるファイルおよび/またはプロジェクトは、ディスクから削除されません。ソリューションフォルダーについて説明したので、次にソリューションエクスプローラーでプロジェクトとさらにやり取りする方法を見てみましょう。

プロジェクトの操作

ソリューションエクスプローラーには、プロジェクトを操作できるようにするための多くの機能があります。ソリューションを初めて開くと、プロジェクトとソリューションフォルダーが表示されます。ソリューションフォルダーまたはプロジェクトを展開して、その内容を表示できます。以下の画像は、いくつかのノードが展開されたソリューションエクスプローラーを示しています。

上記の画像では、ソリューションエクスプローラーでいくつかのソリューションフォルダーとTemplatesWebプロジェクトが展開されていることがわかります。このリリースではファイルネストのサポートは最小限ですが、Visual Studio IDE で見られるファイルネストとより一貫性を持たせるために、そのサポートを拡張する予定です。

ここから、ソリューションエクスプローラーでファイルをダブルクリックして開くことができます。ソリューションエクスプローラーの項目を右クリックして、利用可能なアクションのコンテキスト固有メニューを表示することもできます。例えば、プロジェクトに新しいファイルを追加するには、プロジェクトを右クリックして新しいファイルの追加を選択します。そのオプションを選択すると、デフォルトコンテンツに使用するファイルテンプレートを選択するよう求められます。.NET 7.0.200 以降をターゲットとするプロジェクトで作業している場合、ここで最適なエクスペリエンスが得られます。

また、VS Code で通常通りファイルを作成し、プロジェクトファイルを含むフォルダーに保存することで、プロジェクトにファイルを追加することもできます。デフォルトでは、プロジェクトフォルダーに追加された新しいファイルは、自動的にプロジェクトに追加されます。

プロジェクトビューでは、プロジェクト参照とパッケージ参照の両方について、プロジェクトが持つ依存関係を確認することもできます。このバージョンの C# Dev Kit では、依存関係を変更する機能はありません。プロジェクトまたはパッケージ参照に依存関係を追加するには、dotnet add コマンドラインツールを使用できます。パッケージ参照を追加するには、dotnet add package コマンド - .NET CLI を参照し、プロジェクト参照を追加するには、dotnet add reference コマンド - .NET CLI を参照してください。参照を削除するには、dotnet remove を使用します。詳細については、パッケージ参照を削除する方法とパッケージを削除する方法を参照してください。

プロジェクトファイルを表示または編集したい場合は、ソリューションエクスプローラーでプロジェクトノードを選択すると、プロジェクトファイルがエディターで開きます。これは、ソリューションエクスプローラーでファイルを選択したときと同じ動作です。

ソリューションエクスプローラーを使用して、コンテキストメニューからビルド、リビルド、クリーンなどの一般的なアクションを実行することもできます。これらのコンテキストメニューは、ソリューションエクスプローラーでソリューションノードまたはプロジェクトノードを選択したときに表示されます。これにより、選択された項目とその依存関係がビルド/リビルド/クリーンされます。