dotnet sln

Ez a cikk a következő verziókra vonatkozik: ✔️ .NET 6 SDK és újabb verziók

Név

dotnet sln – Felsorolja vagy módosítja a projekteket egy .NET-megoldásfájlban, vagy áttelepíti a fájlt egy .slnx fájlba.

Áttekintés

dotnet sln [<SOLUTION_FILE>] [command]

dotnet sln [command] -h|--help

Leírás

A dotnet sln paranccsal egyszerűen listázhatja és módosíthatja a projekteket egy megoldásfájlban.

Megoldásfájl létrehozása

A dotnet sln parancs használatához a megoldásfájlnak már léteznie kell. Ha létre kell hoznia egyet, használja a dotnet új parancsot a sln sablon nevével.

Az alábbi példa létrehoz egy .slnx fájlt az aktuális mappában, ugyanazzal a névvel, mint a mappa:

dotnet new sln

Az alábbi példa egy .slnx fájlt hoz létre az aktuális mappában a megadott fájlnévvel:

dotnet new sln --name MySolution

Az alábbi példa egy .slnx fájlt hoz létre a megadott mappában, ugyanazzal a névvel, mint a mappa:

dotnet new sln --output MySolution

Megjegyzés:

A .NET 9-ben és a korábbi verziókban dotnet new sln .slnx-fájl helyett egy .sln fájlt hoz létre.

Érvek

• SOLUTION_FILE

  A használni kívánt megoldásfájl (.sln vagy .slnx fájl).

  Ha nincs meghatározva, a parancs az aktuális könyvtárban keres egy .sln vagy .slnx fájlt, és ha pontosan egyet talál, használja azt a fájlt. Ha több megoldásfájl is található, a rendszer arra kéri a felhasználót, hogy explicit módon adjon meg egy fájlt. Ha egyik sem található, a parancs meghiúsul.

Beállítások

• -?|-h|--helpA parancs használatának leírását nyomtatja ki.

Parancsok

A következő parancsok érhetők el:

• list
• add
• remove
• migrate

list

Egy megoldásfájl összes projektje.

Áttekintés

dotnet sln list [-h|--help]

Érvek

• SOLUTION_FILE

  A használni kívánt megoldásfájl (.sln vagy .slnx fájl) vagy megoldásszűrő (.slnf fájl).

  Ha nincs meghatározva, a parancs az aktuális könyvtárban keres egy .sln, .slnx vagy .slnf fájlt, és ha pontosan egyet talál, használja azt a fájlt. Ha több megoldásfájlt vagy szűrőt talál, a rendszer arra kéri a felhasználót, hogy explicit módon adjon meg egy fájlt. Ha egyik sem található, a parancs meghiúsul.

  (A .slnf-fájlok támogatása a .NET SDK 9.0.3xx verzióban lett hozzáadva.)

Beállítások

• -?|-h|--helpA parancs használatának leírását nyomtatja ki.

add

Egy vagy több projektet ad hozzá a megoldásfájlhoz.

Áttekintés

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

Érvek

• SOLUTION_FILE

  A használni kívánt megoldásfájl (.sln vagy .slnx fájl).

  Ha nincs meghatározva, a parancs az aktuális könyvtárban keres egy .sln vagy .slnx fájlt, és ha pontosan egyet talál, használja azt a fájlt. Ha több megoldásfájl is található, a rendszer arra kéri a felhasználót, hogy explicit módon adjon meg egy fájlt. Ha egyik sem található, a parancs meghiúsul.

• PROJECT_PATH

  A megoldáshoz hozzáadni kívánt projekt vagy projektek elérési útja. A Unix/Linux rendszerhéj globbing mintát bővítményeket a dotnet sln parancs megfelelően dolgozza fel.

  Ha PROJECT_PATH a projektmappát tartalmazó mappákat is tartalmaz, az elérési út azon része lesz használva, amely megoldásmappákat hoz létre. Az alábbi parancsok például myapp a megoldásmappában folder1/folder2:

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

  Ezt az alapértelmezett viselkedést felülbírálhatja a --in-root vagy a -s|--solution-folder <PATH> beállítással.

Beállítások

• -?|-h|--help

  A parancs használatának leírását nyomtatja ki.

• --in-root

  A projekteket a megoldás gyökerében helyezi el ahelyett, hogy megoldásmappát hoz létre. A -s|--solution-foldernem használható.

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

  A cél megoldásmappa a projektek hozzáadásának elérési útját. A --in-rootnem használható.

remove

Eltávolít egy projektet vagy több projektet a megoldásfájlból.

Áttekintés

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

Érvek

• SOLUTION_FILE

  A használni kívánt megoldásfájl (.sln vagy .slnx fájl).

  Ha nincs meghatározva, a parancs az aktuális könyvtárban keres egy .sln vagy .slnx fájlt, és ha pontosan egyet talál, használja azt a fájlt. Ha több megoldásfájl is található, a rendszer arra kéri a felhasználót, hogy explicit módon adjon meg egy fájlt. Ha egyik sem található, a parancs meghiúsul.

• PROJECT_PATH vagy PROJECT_NAME

  A megoldásból eltávolítandó projekt vagy projektek elérési útja vagy neve. A Unix/Linux rendszerhéj globbing mintát bővítményeket a dotnet sln parancs megfelelően dolgozza fel.

  Ha az elérési út helyett egy projektnevet ad meg, a megoldásban lévő, a névnek megfelelő projekt az elérési úttól függetlenül el lesz távolítva. Ha több egyező projekt található a megoldásban, a parancs hibát jelez. Hagyja ki a projektfájl-bővítményt a névből. (A projektek név szerinti eltávolításának támogatása a .NET 10-ben lett hozzáadva.)

Beállítások

• -?|-h|--helpA parancs használatának leírását nyomtatja ki.

migrate

Létrehoz egy .slnx megoldásfájlt egy .sln fájlból.

Áttekintés

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

Érvek

• SOLUTION_FILE

  A migrálni kívánt .sln megoldásfájl.

  Ha nincs meghatározva, a parancs az aktuális könyvtárban keres egy .sln fájlt, és ha pontosan egyet talál, akkor azt a fájlt használja. Ha több .sln fájl található, a rendszer arra kéri a felhasználót, hogy explicit módon adjon meg egy fájlt. Ha egyik sem található, a parancs meghiúsul.

  Ha .sln fájl helyett .slnx fájlt ad meg, vagy ha már létezik egy .slnx fájl ugyanazzal a fájlnévvel (kivéve a .sln kiterjesztést), a parancs meghiúsul.

Beállítások

• -?|-h|--helpA parancs használatának leírását nyomtatja ki.

Példák

• A projektek listázása egy megoldásban:

  dotnet sln todo.slnx list
  

• C#-projekt hozzáadása egy megoldáshoz:

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

• C#-projekt eltávolítása egy megoldásból:

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

• Több C#-projekt hozzáadása a megoldás gyökeréhez:

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

• Több C#-projekt hozzáadása egy megoldáshoz:

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

• Több C#-projekt eltávolítása egy megoldásból:

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

• Több C#-projekt hozzáadása egy megoldáshoz egy globbing mintával (csak Unix/Linux esetén):

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

• Több C#-projekt hozzáadása egy megoldáshoz egy globbing minta használatával (csak Windows PowerShell esetén):

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

• Több C#-projekt eltávolítása egy megoldásból egy globbing minta használatával (csak Unix/Linux esetén):

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

• Több C#-projekt eltávolítása egy megoldásból egy globbing minta használatával (csak Windows PowerShell esetén):

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

• Hozzon létre egy .slnx fájlt egy .sln fájlból:

  dotnet sln todo.sln migrate
  

• Hozzon létre egy megoldást, egy konzolalkalmazást és két osztálytárat. Adja hozzá a projekteket a megoldáshoz, és az --solution-folderdotnet sln beállításával rendezze az osztálytárakat egy megoldásmappába.

  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
  

  Az alábbi képernyőképen a Visual Studio 2019 Solution Explorereredménye látható:

  

Lásd még:

• dotnet/sdk GitHub-adattár (.NET CLI-forrás)