dotnet format
Cet article s’applique à : ✔️ SDK .NET 6.x et versions ultérieures
dotnet format
- Met en forme le code pour qu’il corresponde aux paramètres de editorconfig
.
dotnet format [<PROJECT | SOLUTION>] [command] [options]
dotnet format -h|--help
dotnet format
est un formateur de code qui applique les préférences de style et les recommandations d’analyse statique à un projet ou une solution. Les préférences seront lues à partir d’un fichier .editorconfig, le cas échéant, sinon un ensemble de préférences par défaut sera utilisé. Pour plus d’informations, consultez la documentation EditorConfig.
PROJECT | SOLUTION
Projet ou solution MSBuild sur lequel exécuter la mise en forme du code. Si vous ne spécifiez pas de fichier projet ou solution, MSBuild recherche dans le répertoire de travail actif un fichier dont l’extension se termine par proj ou sln et l’utilise.
Aucune des options ci-dessous n’est requise pour que la commande dotnet format
réussisse, mais vous pouvez les utiliser pour personnaliser davantage ce qui est mis en forme et selon quelles règles.
--diagnostics <DIAGNOSTICS>
Liste d’ID de diagnostic séparés par des espaces à utiliser comme un filtre lors de la résolution des problèmes liés à des tiers ou au style de code. La valeur par défaut correspond à celle des ID répertoriés dans le fichier .editorconfig. Pour obtenir la liste des ID de règle d’analyseur intégré que vous pouvez spécifier, consultez la liste des ID pour les règles de style d’analyse de code.
--severity
Gravité minimale des diagnostics à corriger. Les valeurs autorisées sont
info
,warn
eterror
. La valeur par défaut estwarn
.--no-restore
N’exécute pas de restauration implicite avant la mise en forme. La valeur par défaut consiste à effectuer une restauration implicite.
--verify-no-changes
Vérifie qu’aucune modification de mise en forme n’est effectuée. Se termine par un code de sortie différent de zéro si des fichiers ont été mis en forme.
--include <INCLUDE>
Liste séparée par des espaces qui indique le chemin d’accès relatif aux fichiers ou dossiers à inclure dans la mise en forme. La valeur par défaut correspond à tous les fichiers de la solution ou du projet.
--exclude <EXCLUDE>
Liste séparée par des espaces qui indique le chemin d’accès relatif aux fichiers ou dossiers à exclure de la mise en forme. La valeur par défaut est aucune gestion.
--include-generated
Met en forme les fichiers générés par le Kit de développement logiciel (SDK).
-v|--verbosity <LEVEL>
Définit le niveau de détail. Les valeurs autorisées sont
q[uiet]
,m[inimal]
,n[ormal]
,d[etailed]
etdiag[nostic]
. La valeur par défaut estm[inimal]
.--binarylog <BINARY-LOG-PATH>
Consigne toutes les informations de chargement de projet ou de solution dans un fichier journal binaire.
--report <REPORT-PATH>
Génère un rapport JSON dans le répertoire spécifié par
<REPORT_PATH>
.-h|--help
Affiche les informations d’aide et d’utilisation
dotnet format whitespace
- Met en forme le code pour qu’il corresponde aux paramètres de editorconfig
pour l’espace blanc.
La dotnet format whitespace
sous-commande exécute uniquement les règles de mise en forme associées à la mise en forme d’espace blanc. Pour obtenir la liste complète des options de mise en forme possibles que vous pouvez spécifier dans votre fichier .editorconfig, consultez les options de mise en forme C#.
--folder
Traitez l’argument
<PROJECT | SOLUTION>
comme un chemin d’accès à un dossier simple de fichiers de code.
dotnet format style
- Met en forme le code pour qu’il corresponde aux paramètres EditorConfig pour le style de code.
La dotnet format style
sous-commande exécute uniquement les règles de mise en forme associées à la mise en forme du style de code. Pour obtenir la liste complète des options de mise en forme que vous pouvez spécifier dans votre fichier editorconfig
, consultez Règles de style de code.
--diagnostics <DIAGNOSTICS>
Liste séparée par un espace des ID de diagnostic à utiliser comme filtre lors de la résolution des problèmes de style de code. La valeur par défaut correspond à celle des ID répertoriés dans le fichier .editorconfig. Pour obtenir la liste des ID de règle d’analyseur de style de code intégrés que vous pouvez spécifier, consultez la liste des ID pour les règles de style d’analyse du code.
--severity
Gravité minimale des diagnostics à corriger. Les valeurs autorisées sont
info
,warn
eterror
. La valeur par défaut estwarn
.
dotnet format analyzers
- Met en forme le code pour qu’il corresponde editorconfig
aux paramètres des analyseurs (à l’exclusion des règles de style de code).
La dotnet format analyzers
sous-commande exécute uniquement les règles de mise en forme associées aux analyseurs. Pour obtenir la liste des règles d’analyseur que vous pouvez spécifier dans votre editorconfig
fichier, consultez Règles de qualité.
--diagnostics <DIAGNOSTICS>
Liste séparée par un espace des ID de diagnostic à utiliser comme filtre lors de la résolution des problèmes de style non de code. La valeur par défaut correspond à celle des ID répertoriés dans le fichier .editorconfig. Pour obtenir la liste des ID de règle d’analyseur intégrés que vous pouvez spécifier, consultez la liste des ID pour les règles de qualité. Pour les analyseurs tiers, reportez-vous à leur documentation.
--severity
Gravité minimale des diagnostics à corriger. Les valeurs autorisées sont
info
,warn
eterror
. La valeur par défaut estwarn
.
Mettez en forme tout le code dans la solution :
CLI .NETdotnet format ./solution.sln
Nettoyez tout le code dans le projet d’application :
CLI .NETdotnet format ./src/application.csproj
Vérifiez que tout le code est correctement mis en forme :
CLI .NETdotnet format --verify-no-changes
Nettoyez tout le code dans le répertoire src et tests , mais pas dans src/submodule-a :
CLI .NETdotnet format --include ./src/ ./tests/ --exclude ./src/submodule-a/
Résolution d’un problème spécifique de style de code :
CLI .NETdotnet format style --diagnostics IDE0005 --severity info
Corrigez tous les problèmes de style de code qui ont une
info
gravité,warning
ouerror
:CLI .NETdotnet format style --severity info
Résolution d’un problème d’analyseur spécifique (non de style de code) :
CLI .NETdotnet format analyzers --diagnostics CA1831 --severity warn
Corrigez tous les problèmes de style non de code qui ont une
info
gravité,warning
ouerror
:CLI .NETdotnet format analyzers --severity info
Commentaires sur .NET
.NET est un projet open source. Sélectionnez un lien pour fournir des commentaires :