dotnet sln

Artikel ini berlaku untuk: ✔️ .NET 6 SDK dan versi yang lebih baru

Nama

dotnet sln - Mencantumkan atau memodifikasi proyek dalam file solusi .NET, atau memigrasikan file ke file .slnx.

Sinopsis

dotnet sln [<SOLUTION_FILE>] [command]

dotnet sln [command] -h|--help

Deskripsi

Perintah dotnet sln menyediakan cara mudah untuk mencantumkan dan memodifikasi proyek dalam file solusi.

Membuat file solusi

Untuk menggunakan perintah dotnet sln, file solusi harus sudah ada. Jika Anda perlu membuatnya, gunakan perintah baru dotnet dengan nama templat sln.

Contoh berikut membuat file .slnx di folder saat ini, dengan nama yang sama dengan folder:

dotnet new sln

Contoh berikut membuat file .slnx di folder saat ini, dengan nama file yang ditentukan:

dotnet new sln --name MySolution

Contoh berikut membuat file .slnx di folder yang ditentukan, dengan nama yang sama dengan folder :

dotnet new sln --output MySolution

Nota

Di .NET 9 dan versi yang lebih lama, dotnet new sln membuat file .sln alih-alih file .slnx .

Argumen

• SOLUTION_FILE

  File solusi yang akan digunakan (file .sln atau .slnx).

  Jika tidak ditentukan, perintah mencari direktori saat ini untuk file .sln atau .slnx dan, jika menemukan persis satu, menggunakan file tersebut. Jika beberapa file solusi ditemukan, pengguna diminta untuk menentukan file secara eksplisit. Jika tidak ada yang ditemukan, perintah gagal.

Opsi

• -?|-h|--helpMencetak deskripsi cara menggunakan perintah.

Perintah

Perintah berikut ini tersedia:

• list
• add
• remove
• migrate

list

Mencantumkan semua proyek dalam file solusi.

Sinopsis

dotnet sln list [-h|--help]

Argumen

• SOLUTION_FILE

  File solusi (file .sln atau .slnx ) atau filter solusi (file.slnf ) untuk digunakan.

  Jika tidak ditentukan, perintah mencari direktori saat ini untuk file .sln, .slnx, atau .slnf dan, jika menemukan persis satu, menggunakan file tersebut. Jika beberapa file solusi atau filter ditemukan, pengguna diminta untuk menentukan file secara eksplisit. Jika tidak ada yang ditemukan, perintah gagal.

  (Dukungan untuk file .slnf ditambahkan di .NET SDK 9.0.3xx.)

Opsi

• -?|-h|--helpMencetak deskripsi cara menggunakan perintah.

add

Menambahkan satu atau beberapa proyek ke file solusi.

Sinopsis

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

Argumen

• SOLUTION_FILE

  File solusi yang akan digunakan (file .sln atau .slnx).

  Jika tidak ditentukan, perintah mencari direktori saat ini untuk file .sln atau .slnx dan, jika menemukan persis satu, menggunakan file tersebut. Jika beberapa file solusi ditemukan, pengguna diminta untuk menentukan file secara eksplisit. Jika tidak ada yang ditemukan, perintah gagal.

• PROJECT_PATH

  Jalur ke proyek atau proyek untuk ditambahkan ke solusi. Unix/Linux shell pola globbing ekspansi diproses dengan benar oleh perintah dotnet sln.

  Jika PROJECT_PATH menyertakan folder yang berisi folder proyek, bagian jalur tersebut digunakan untuk membuat folder solusi . Misalnya, perintah berikut membuat solusi dengan myapp di folder solusi folder1/folder2:

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

  Anda dapat mengambil alih perilaku default ini dengan menggunakan opsi --in-root atau -s|--solution-folder <PATH>.

Opsi

• -?|-h|--help

  Mencetak deskripsi cara menggunakan perintah.

• --in-root

  Tempatkan proyek di akar solusi, daripada membuat folder solusi . Tidak dapat digunakan dengan -s|--solution-folder.

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

  Folder solusi tujuan jalur untuk menambahkan proyek. Tidak dapat digunakan dengan --in-root.

remove

Menghapus proyek atau beberapa proyek dari file solusi.

Sinopsis

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

Argumen

• SOLUTION_FILE

  File solusi yang akan digunakan (file .sln atau .slnx).

  Jika tidak ditentukan, perintah mencari direktori saat ini untuk file .sln atau .slnx dan, jika menemukan persis satu, menggunakan file tersebut. Jika beberapa file solusi ditemukan, pengguna diminta untuk menentukan file secara eksplisit. Jika tidak ada yang ditemukan, perintah gagal.

• PROJECT_PATH atau PROJECT_NAME

  Jalur ke, atau nama, proyek atau proyek yang akan dihapus dari solusi. Unix/Linux shell pola globbing ekspansi diproses dengan benar oleh perintah dotnet sln.

  Jika nama proyek disediakan alih-alih jalur, proyek dalam solusi yang cocok dengan namanya, terlepas dari jalurnya, dihapus. Jika lebih dari satu proyek yang cocok ditemukan dalam solusi, perintah akan keluar. Hilangkan ekstensi file proyek dalam nama. (Dukungan untuk menghapus proyek berdasarkan nama ditambahkan di .NET 10.)

Opsi

• -?|-h|--helpMencetak deskripsi cara menggunakan perintah.

migrate

Menghasilkan file solusi .slnx dari file .sln.

Sinopsis

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

Argumen

• SOLUTION_FILE

  File solusi .sln untuk dimigrasikan.

  Jika tidak ditentukan, perintah mencari direktori saat ini untuk file .sln dan, jika ditemukan persis satu, menggunakan file tersebut. Jika beberapa file .sln ditemukan, pengguna diminta untuk menentukan file secara eksplisit. Jika tidak ada yang ditemukan, perintah gagal.

  Jika Anda menentukan file .slnx alih-alih file .sln, atau jika file .slnx dengan nama file yang sama (dikurangi ekstensi .sln) sudah ada di direktori, perintah gagal.

Opsi

• -?|-h|--helpMencetak deskripsi cara menggunakan perintah.

Contoh

• Cantumkan proyek dalam solusi:

  dotnet sln todo.slnx list
  

• Tambahkan proyek C# ke solusi:

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

• Hapus proyek C# dari solusi:

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

• Tambahkan beberapa proyek C# ke akar solusi:

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

• Tambahkan beberapa proyek C# ke solusi:

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

• Hapus beberapa proyek C# dari solusi:

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

• Tambahkan beberapa proyek C# ke solusi menggunakan pola globbing (hanya Unix/Linux):

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

• Tambahkan beberapa proyek C# ke solusi menggunakan pola globbing (hanya Windows PowerShell):

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

• Hapus beberapa proyek C# dari solusi menggunakan pola globbing (hanya Unix/Linux):

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

• Hapus beberapa proyek C# dari solusi menggunakan pola globbing (hanya Windows PowerShell):

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

• Buat file .slnx dari file .sln:

  dotnet sln todo.sln migrate
  

• Buat solusi, aplikasi konsol, dan dua pustaka kelas. Tambahkan proyek ke solusi, dan gunakan opsi --solution-folderdotnet sln untuk menata pustaka kelas ke dalam folder solusi.

  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
  

  Cuplikan layar berikut menunjukkan hasilnya di Penjelajah Solusi Visual Studio 2019:

  

Lihat juga

• repositori GitHub dotnet/sdk (sumber CLI.NET)