dotnet sln

Dit artikel is van toepassing op: ✔️ .NET Core 3.1 SDK en latere versies

Naam

dotnet sln: hiermee worden de projecten in een .NET-oplossingsbestand weergegeven of gewijzigd of wordt het bestand gemigreerd naar een .slnx--bestand.

Samenvatting

dotnet sln [<SOLUTION_FILE>] [command]

dotnet sln [command] -h|--help

Beschrijving

De opdracht dotnet sln biedt een handige manier om projecten in een oplossingsbestand weer te geven en te wijzigen.

Een oplossingsbestand maken

Als u de opdracht dotnet sln wilt gebruiken, moet het oplossingsbestand al bestaan. Als u er een wilt maken, gebruikt u de opdracht dotnet new met de naam van de sln-sjabloon.

In het volgende voorbeeld wordt een .sln bestand gemaakt in de huidige map, met dezelfde naam als de map:

dotnet new sln

In het volgende voorbeeld wordt een .sln bestand gemaakt in de huidige map, met de opgegeven bestandsnaam:

dotnet new sln --name MySolution

In het volgende voorbeeld wordt een .sln bestand in de opgegeven map gemaakt, met dezelfde naam als de map:

dotnet new sln --output MySolution

Argumenten

• SOLUTION_FILE

  Het oplossingsbestand dat moet worden gebruikt (een .sln of .slnx-bestand).

  Als dit niet is opgegeven, zoekt de opdracht in de huidige map naar een .sln of .slnx--bestand en gebruikt het bestand, als het precies één bestand vindt. Als er meerdere oplossingsbestanden worden gevonden, wordt de gebruiker gevraagd een bestand expliciet op te geven. Als er geen is gevonden, mislukt de opdracht.

Opties

• -?|-h|--help

  Hiermee wordt een beschrijving afgedrukt van het gebruik van de opdracht.

Opdrachten

De volgende opdrachten zijn beschikbaar:

• list
• add
• remove
• migrate

list

Een lijst met alle projecten in een oplossingsbestand.

Samenvatting

dotnet sln list [-h|--help]

Argumenten

• SOLUTION_FILE

  Het oplossingsbestand dat moet worden gebruikt (een .sln of .slnx-bestand).

  Als dit niet is opgegeven, zoekt de opdracht in de huidige map naar een .sln of .slnx--bestand en gebruikt het bestand, als het precies één bestand vindt. Als er meerdere oplossingsbestanden worden gevonden, wordt de gebruiker gevraagd een bestand expliciet op te geven. Als er geen is gevonden, mislukt de opdracht.

Opties

• -?|-h|--help

  Hiermee wordt een beschrijving afgedrukt van het gebruik van de opdracht.

add

Voegt een of meer projecten toe aan het oplossingsbestand.

Samenvatting

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

Argumenten

• SOLUTION_FILE

  Het oplossingsbestand dat moet worden gebruikt (een .sln of .slnx-bestand).

  Als dit niet is opgegeven, zoekt de opdracht in de huidige map naar een .sln of .slnx--bestand en gebruikt het bestand, als het precies één bestand vindt. Als er meerdere oplossingsbestanden worden gevonden, wordt de gebruiker gevraagd een bestand expliciet op te geven. Als er geen is gevonden, mislukt de opdracht.

• PROJECT_PATH

  Het pad naar het project of de projecten die u aan de oplossing wilt toevoegen. Unix/Linux-shell globbing-patroon uitbreidingen correct worden verwerkt door de opdracht dotnet sln.

  Als PROJECT_PATH mappen bevat die de projectmap bevatten, wordt dat gedeelte van het pad gebruikt om oplossingsmappente maken. Met de volgende opdrachten maakt u bijvoorbeeld een oplossing met myapp in de oplossingsmap folder1/folder2:

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

  U kunt dit standaardgedrag overschrijven met behulp van de --in-root of de optie -s|--solution-folder <PATH>.

Opties

• -?|-h|--help

  Hiermee wordt een beschrijving afgedrukt van het gebruik van de opdracht.

• --in-root

  Plaatst de projecten in de hoofdmap van de oplossing, in plaats van een oplossingsmap te maken. Kan niet worden gebruikt met -s|--solution-folder.

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

  De doelmap oplossing pad om de projecten toe te voegen. Kan niet worden gebruikt met --in-root.

remove

Hiermee verwijdert u een project of meerdere projecten uit het oplossingsbestand.

Samenvatting

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

Argumenten

• SOLUTION_FILE

  Het oplossingsbestand dat moet worden gebruikt (een .sln of .slnx-bestand).

  Als dit niet is opgegeven, zoekt de opdracht in de huidige map naar een .sln of .slnx--bestand en gebruikt het bestand, als het precies één bestand vindt. Als er meerdere oplossingsbestanden worden gevonden, wordt de gebruiker gevraagd een bestand expliciet op te geven. Als er geen is gevonden, mislukt de opdracht.

• PROJECT_PATH

  Het pad naar het project of de projecten die u uit de oplossing wilt verwijderen. Unix/Linux-shell globbing-patroon uitbreidingen correct worden verwerkt door de opdracht dotnet sln.

Opties

• -?|-h|--help

  Hiermee wordt een beschrijving afgedrukt van het gebruik van de opdracht.

migrate

Genereert een .slnx--oplossingsbestand van een .sln-bestand.

Samenvatting

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

Argumenten

• SOLUTION_FILE

  Het .sln oplossingsbestand dat moet worden gemigreerd.

  Als dit niet is opgegeven, zoekt de opdracht in de huidige map naar een .sln bestand en gebruikt het bestand, als het precies een bestand vindt. Als er meerdere .sln bestanden worden gevonden, wordt de gebruiker gevraagd een bestand expliciet op te geven. Als er geen is gevonden, mislukt de opdracht.

  Als u een .slnx--bestand opgeeft in plaats van een .sln bestand, of als er al een .slnx--bestand met dezelfde bestandsnaam (min de extensie .sln) bestaat in de map, mislukt de opdracht.

Opties

• -?|-h|--help

  Hiermee wordt een beschrijving afgedrukt van het gebruik van de opdracht.

Voorbeelden

• De projecten in een oplossing weergeven:

  dotnet sln todo.slnx list
  

• Een C#-project toevoegen aan een oplossing:

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

• Een C#-project verwijderen uit een oplossing:

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

• Voeg meerdere C#-projecten toe aan de hoofdmap van een oplossing:

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

• Meerdere C#-projecten toevoegen aan een oplossing:

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

• Meerdere C#-projecten verwijderen uit een oplossing:

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

• Voeg meerdere C#-projecten toe aan een oplossing met behulp van een globbing-patroon (alleen Unix/Linux):

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

• Meerdere C#-projecten toevoegen aan een oplossing met behulp van een globbing-patroon (alleen Windows PowerShell):

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

• Verwijder meerdere C#-projecten uit een oplossing met behulp van een globbing-patroon (alleen Unix/Linux):

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

• Verwijder meerdere C#-projecten uit een oplossing met behulp van een globbing-patroon (alleen Windows PowerShell):

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

• Genereer een .slnx--bestand op basis van een .sln-bestand:

  dotnet sln todo.sln migrate
  

• Maak een oplossing, een console-app en twee klassebibliotheken. Voeg de projecten toe aan de oplossing en gebruik de --solution-folder optie van dotnet sln om de klassebibliotheken te organiseren in een oplossingsmap.

  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
  

  In de volgende schermopname ziet u het resultaat in Visual Studio 2019 Solution Explorer:

  

Zie ook

• dotnet/sdk GitHub-opslagplaats (.NET CLI-bron)