dotnet sln

この記事は、✔️.NET Core 3.1 SDK 以降のバージョン 適用されます

名前

dotnet sln - .NET ソリューション ファイル内のプロジェクトを一覧表示または変更するか、ファイルを .slnx ファイルに移行します。

概要

dotnet sln [<SOLUTION_FILE>] [command]

dotnet sln [command] -h|--help

形容

dotnet sln コマンドを使用すると、ソリューション ファイル内のプロジェクトを一覧表示および変更するのに便利な方法が提供されます。

ソリューション ファイルを作成する

dotnet sln コマンドを使用するには、ソリューション ファイルが既に存在している必要があります。 作成する必要がある場合は、sln テンプレート名で dotnet new コマンドを使用します。

次の例では、フォルダーと同じ名前の .sln ファイルを現在のフォルダーに作成します。

dotnet new sln

次の例では、指定したファイル名を使用して、現在のフォルダーに .sln ファイルを作成します。

dotnet new sln --name MySolution

次の例では、指定したフォルダーにフォルダーと同じ名前の .sln ファイルを作成します。

dotnet new sln --output MySolution

引数

• SOLUTION_FILE

  使用するソリューション ファイル (.sln または .slnx ファイル)。

  指定しない場合、コマンドは現在のディレクトリで .sln を検索するか、.slnx ファイル 検索し、正確に見つかると、そのファイルが使用されます。 複数のソリューション ファイルが見つかった場合、ユーザーはファイルを明示的に指定するように求められます。 何も見つからない場合、コマンドは失敗します。

オプション

• -?|-h|--help

  コマンドの使用方法の説明を出力します。

コマンド

次のコマンドを使用できます。

• list
• add
• remove
• migrate

list

ソリューション ファイル内のすべてのプロジェクトを一覧表示します。

概要

dotnet sln list [-h|--help]

引数

• SOLUTION_FILE

  使用するソリューション ファイル (.sln または .slnx ファイル)。

  指定しない場合、コマンドは現在のディレクトリで .sln を検索するか、.slnx ファイル 検索し、正確に見つかると、そのファイルが使用されます。 複数のソリューション ファイルが見つかった場合、ユーザーはファイルを明示的に指定するように求められます。 何も見つからない場合、コマンドは失敗します。

オプション

• -?|-h|--help

  コマンドの使用方法の説明を出力します。

add

ソリューション ファイルに 1 つ以上のプロジェクトを追加します。

概要

dotnet sln [<SOLUTION_FILE>] add [--in-root] [-s|--solution-folder <PATH>] <PROJECT_PATH> [<PROJECT_PATH>...]
dotnet sln add [-h|--help]

引数

• SOLUTION_FILE

  使用するソリューション ファイル (.sln または .slnx ファイル)。

  指定しない場合、コマンドは現在のディレクトリで .sln を検索するか、.slnx ファイル 検索し、正確に見つかると、そのファイルが使用されます。 複数のソリューション ファイルが見つかった場合、ユーザーはファイルを明示的に指定するように求められます。 何も見つからない場合、コマンドは失敗します。

• PROJECT_PATH

  ソリューションに追加するプロジェクトへのパス。 unix/Linux シェル globbing パターン 展開は、dotnet sln コマンドによって正しく処理されます。

  プロジェクト フォルダーを含むフォルダー PROJECT_PATH 含まれている場合は、パスのその部分を使用して、ソリューション フォルダー 作成します。 たとえば、次のコマンドを実行すると、ソリューション フォルダー folder1/folder2に myapp を含むソリューションが作成されます。

  dotnet new sln
  dotnet new console --output folder1/folder2/myapp
  dotnet sln add folder1/folder2/myapp
  

  この既定の動作は、--in-root または -s|--solution-folder <PATH> オプションを使用してオーバーライドできます。

オプション

• -?|-h|--help

  コマンドの使用方法の説明を出力します。

• --in-root

  ソリューション フォルダーを作成するのではなく、ソリューションのルートにプロジェクト配置します。 -s|--solution-folderでは使用できません。

• -s|--solution-folder <PATH>

  プロジェクト 追加先のソリューション フォルダー パスです。 --in-rootでは使用できません。

remove

ソリューション ファイルからプロジェクトまたは複数のプロジェクトを削除します。

概要

dotnet sln [<SOLUTION_FILE>] remove <PROJECT_PATH> [<PROJECT_PATH>...]
dotnet sln [<SOLUTION_FILE>] remove [-h|--help]

引数

• SOLUTION_FILE

  使用するソリューション ファイル (.sln または .slnx ファイル)。

  指定しない場合、コマンドは現在のディレクトリで .sln を検索するか、.slnx ファイル 検索し、正確に見つかると、そのファイルが使用されます。 複数のソリューション ファイルが見つかった場合、ユーザーはファイルを明示的に指定するように求められます。 何も見つからない場合、コマンドは失敗します。

• PROJECT_PATH

  ソリューションから削除するプロジェクトへのパス。 unix/Linux シェル globbing パターン 展開は、dotnet sln コマンドによって正しく処理されます。

オプション

• -?|-h|--help

  コマンドの使用方法の説明を出力します。

migrate

.sln ファイルから .slnx ソリューション ファイルを生成します。

概要

dotnet sln [<SOLUTION_FILE>] migrate
dotnet sln [<SOLUTION_FILE>] migrate [-h|--help]

引数

• SOLUTION_FILE

  移行する .sln ソリューション ファイル。

  指定しない場合、コマンドは現在のディレクトリで .sln ファイルを検索し、正確に 1 つを見つけた場合は、そのファイルを使用します。 複数の .sln ファイルが見つかった場合、ユーザーはファイルを明示的に指定するように求められます。 何も見つからない場合、コマンドは失敗します。

  .sln ファイルの代わりに .slnx ファイルを指定した場合、または同じファイル名 (.sln 拡張子を除く) を持つ .slnx ファイルが既にディレクトリに存在する場合、コマンドは失敗します。

オプション

• -?|-h|--help

  コマンドの使用方法の説明を出力します。

例

• ソリューション内のプロジェクトを一覧表示します。

  dotnet sln todo.slnx list
  

• ソリューションに C# プロジェクトを追加します。

  dotnet sln add todo-app/todo-app.csproj
  

• ソリューションから C# プロジェクトを削除します。

  dotnet sln remove todo-app/todo-app.csproj
  

• ソリューションのルートに複数の C# プロジェクトを追加します。

  dotnet sln todo.slnx add todo-app/todo-app.csproj back-end/back-end.csproj --in-root
  

• ソリューションに複数の C# プロジェクトを追加します。

  dotnet sln todo.slnx add todo-app/todo-app.csproj back-end/back-end.csproj
  

• ソリューションから複数の C# プロジェクトを削除します。

  dotnet sln todo.slnx remove todo-app/todo-app.csproj back-end/back-end.csproj
  

• globbing パターンを使用して複数の C# プロジェクトをソリューションに追加します (Unix/Linux のみ)。

  dotnet sln todo.slnx add **/*.csproj
  

• globbing パターンを使用して複数の C# プロジェクトをソリューションに追加します (Windows PowerShell のみ)。

  dotnet sln todo.slnx add (ls -r **/*.csproj)
  

• globbing パターンを使用してソリューションから複数の C# プロジェクトを削除します (Unix/Linux のみ)。

  dotnet sln todo.slnx remove **/*.csproj
  

• globbing パターンを使用してソリューションから複数の C# プロジェクトを削除します (Windows PowerShell のみ)。

  dotnet sln todo.slnx remove (ls -r **/*.csproj)
  

• .sln ファイルから .slnx ファイルを生成します。

  dotnet sln todo.sln migrate
  

• ソリューション、コンソール アプリ、および 2 つのクラス ライブラリを作成します。 プロジェクトをソリューションに追加し、dotnet sln の --solution-folder オプションを使用して、クラス ライブラリをソリューション フォルダーに整理します。

  dotnet new sln -n mysolution
  dotnet new console -o myapp
  dotnet new classlib -o mylib1
  dotnet new classlib -o mylib2
  dotnet sln mysolution.slnx add myapp\myapp.csproj
  dotnet sln mysolution.slnx add mylib1\mylib1.csproj --solution-folder mylibs
  dotnet sln mysolution.slnx add mylib2\mylib2.csproj --solution-folder mylibs
  

  次のスクリーンショットは、Visual Studio 2019 ソリューション エクスプローラーの結果を示しています。

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

関連項目

• dotnet/sdk GitHub リポジトリ の (.NET CLI ソース)