Lire en anglais

Partager via


dotnet sln

Cet article s’applique à : ✔️ SDK .NET Core 3.1 et versions ultérieures

Nom

dotnet sln : répertorie ou modifie les projets dans un fichier de solution .NET.

Synopsis

CLI .NET
dotnet sln [<SOLUTION_FILE>] [command]

dotnet sln [command] -h|--help

Description

La commande dotnet sln offre un moyen pratique de répertorier et de modifier des projets dans un fichier de solution.

Créer un fichier de solution

Pour que la commande dotnet sln puisse être utilisée, le fichier solution doit déjà exister. Si vous devez en créer un, utilisez la commande dotnet new avec le nom du modèle sln.

L’exemple suivant crée un fichier .sln dans le dossier actif, portant le même nom que le dossier :

CLI .NET
dotnet new sln

L’exemple suivant crée un fichier .sln dans le dossier actif, avec le nom de fichier spécifié :

CLI .NET
dotnet new sln --name MySolution

L’exemple suivant crée un fichier .sln dans le dossier spécifié, portant le même nom que le dossier :

CLI .NET
dotnet new sln --output MySolution

Arguments

  • SOLUTION_FILE

    Fichier de solution à utiliser. Si cet argument est omis, la commande en recherche un dans le répertoire actif. Si elle ne trouve aucun fichier de solution ou plusieurs fichiers de solution, la commande échoue.

Options

  • -?|-h|--help

    Imprime une description de l’utilisation de la commande.

Commandes

list

Liste tous les projets dans un fichier solution.

Synopsis

CLI .NET
dotnet sln list [-h|--help]

Arguments

  • SOLUTION_FILE

    Fichier de solution à utiliser. Si cet argument est omis, la commande en recherche un dans le répertoire actif. Si elle ne trouve aucun fichier de solution ou plusieurs fichiers de solution, la commande échoue.

Options

  • -?|-h|--help

    Imprime une description de l’utilisation de la commande.

add

Ajoute un ou plusieurs projets au fichier de solution.

Synopsis

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

Arguments

  • SOLUTION_FILE

    Fichier de solution à utiliser. S’il n’est pas spécifié, la commande en recherche un dans le répertoire actif et échoue s’il existe plusieurs fichiers de solution.

  • PROJECT_PATH

    Chemin d’accès au projet ou aux projets à ajouter à la solution. Les extensions de modèle Glob d’interpréteur de commandes Unix/Linux sont traitées correctement par la commande dotnet sln.

    Si PROJECT_PATH inclut des dossiers qui contiennent le dossier du projet, cette partie du chemin d’accès est utilisée pour créer des dossiers de solution. Par exemple, les commandes suivantes créent une solution avec myapp dans le dossier de solution folder1/folder2 :

    CLI .NET
    dotnet new sln
    dotnet new console --output folder1/folder2/myapp
    dotnet sln add folder1/folder2/myapp
    

    Vous pouvez remplacer ce comportement par défaut à l’aide de l’option --in-root ou -s|--solution-folder <PATH>.

Options

  • -?|-h|--help

    Imprime une description de l’utilisation de la commande.

  • --in-root

    Place les projets à la racine de la solution, au lieu de créer un dossier de solution. Impossible à utiliser avec -s|--solution-folder.

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

    Chemin de dossier de solution de destination où les projets doivent être ajoutés. Impossible à utiliser avec --in-root.

remove

Supprime un ou plusieurs projets du fichier solution.

Synopsis

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

Arguments

  • SOLUTION_FILE

    Fichier de solution à utiliser. S’il n’est pas spécifié, la commande en recherche un dans le répertoire actif et échoue s’il existe plusieurs fichiers de solution.

  • PROJECT_PATH

    Chemin d’accès au projet ou aux projets à supprimer de la solution. Les extensions de modèle Glob d’interpréteur de commandes Unix/Linux sont traitées correctement par la commande dotnet sln.

Options

  • -?|-h|--help

    Affiche une description de l’utilisation de la commande.

Exemples

  • Répertorier les projets d’une solution :

    CLI .NET
    dotnet sln todo.sln list
    
  • Ajouter un projet C# à une solution :

    CLI .NET
    dotnet sln add todo-app/todo-app.csproj
    
  • Supprimer un projet C# d’une solution :

    CLI .NET
    dotnet sln remove todo-app/todo-app.csproj
    
  • Ajouter plusieurs projets C# à la racine d’une solution :

    CLI .NET
    dotnet sln todo.sln add todo-app/todo-app.csproj back-end/back-end.csproj --in-root
    
  • Ajouter plusieurs projets C# à une solution :

    CLI .NET
    dotnet sln todo.sln add todo-app/todo-app.csproj back-end/back-end.csproj
    
  • Supprimer plusieurs projets C# d’une solution :

    CLI .NET
    dotnet sln todo.sln remove todo-app/todo-app.csproj back-end/back-end.csproj
    
  • Ajouter plusieurs projets C# à une solution à l’aide d’un modèle Glob (Unix/Linux uniquement) :

    CLI .NET
    dotnet sln todo.sln add **/*.csproj
    
  • Ajouter plusieurs projets C# à une solution à l’aide d’un modèle Glob (Windows PowerShell uniquement) :

    CLI .NET
    dotnet sln todo.sln add (ls -r **/*.csproj)
    
  • Supprimer plusieurs projets C# d’une solution à l’aide d’un modèle Glob (Unix/Linux uniquement) :

    CLI .NET
    dotnet sln todo.sln remove **/*.csproj
    
  • Supprimer plusieurs projets C# d’une solution à l’aide d’un modèle Glob (Windows PowerShell uniquement) :

    CLI .NET
    dotnet sln todo.sln remove (ls -r **/*.csproj)
    
  • Créez une solution, une application console et deux bibliothèques de classes. Ajoutez les projets à la solution et utilisez l’option --solution-folder de dotnet sln pour organiser les bibliothèques de classes dans un dossier de solution.

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

    La capture d’écran suivante montre le résultat dans l’Explorateur de solutions Visual Studio 2019 :

    Explorateur de solutions montrant les projets de bibliothèque de classes regroupés dans un dossier de solution.

Voir aussi