dotnet-indeling
Dit artikel is van toepassing op: ✔️ .NET 6.x SDK en latere versies
dotnet format
- Hiermee wordt code opgemaakt zodat deze overeenkomt met editorconfig
de instellingen.
dotnet format [<PROJECT | SOLUTION>] [command] [options]
dotnet format -h|--help
dotnet format
is een codeopmaaker die stijlvoorkeuren en aanbevelingen voor statische analyse toepast op een project of oplossing. Voorkeuren worden gelezen uit een .editorconfig-bestand , indien aanwezig, anders wordt een standaardset voorkeuren gebruikt. Zie de EditorConfig-documentatie voor meer informatie.
PROJECT | SOLUTION
Het MSBuild-project of de oplossing voor het uitvoeren van codeopmaak. Als er geen project- of oplossingsbestand is opgegeven, zoekt MSBuild in de huidige werkmap naar een bestand met een bestandsextensie die eindigt op proj of sln, en gebruikt dat bestand.
Er zijn geen van de onderstaande opties vereist om de dotnet format
opdracht te voltooien, maar u kunt deze gebruiken om verder aan te passen wat is opgemaakt en door welke regels.
--diagnostics <DIAGNOSTICS>
Een door spaties gescheiden lijst met diagnostische id's die moeten worden gebruikt als filter bij het oplossen van codestijl of problemen van derden. De standaardwaarde is de id's die worden vermeld in het .editorconfig-bestand . Zie de lijst met id's voor codeanalysestijlregels voor een lijst met ingebouwde regel-id's die u kunt opgeven.
--severity
De minimale ernst van diagnostische gegevens die moet worden opgelost. Toegestane waarden zijn
info
,warn
enerror
. De standaardwaarde iswarn
.--no-restore
Voert geen impliciete herstelbewerking uit vóór opmaak. Standaard is impliciet herstellen.
--verify-no-changes
Controleert of er geen opmaakwijzigingen worden uitgevoerd. Eindigt met een niet-nul afsluitcode als bestanden zouden zijn opgemaakt.
--include <INCLUDE>
Een door spaties gescheiden lijst met relatieve bestands- of mappaden die moeten worden opgenomen in opmaak. De standaardwaarde is alle bestanden in de oplossing of het project.
--exclude <EXCLUDE>
Een door spaties gescheiden lijst met relatieve bestands- of mappaden die moeten worden uitgesloten van opmaak. De standaardwaarde is geen.
--include-generated
Hiermee worden bestanden opgemaakt die zijn gegenereerd door de SDK.
-v|--verbosity <LEVEL>
Hiermee stelt u het uitgebreidheidsniveau in. Toegestane waarden zijn
q[uiet]
, , ,n[ormal]
endiag[nostic]
d[etailed]
m[inimal]
. De standaardwaarde ism[inimal]
.--binarylog <BINARY-LOG-PATH>
Registreert alle project- of oplossingsinformatie voor het laden van gegevens in een binair logboekbestand.
--report <REPORT-PATH>
Produceert een JSON-rapport in de map die is opgegeven door
<REPORT_PATH>
.-h|--help
Geeft help- en gebruiksgegevens weer
dotnet format whitespace
- Hiermee wordt code opgemaakt zodat deze overeenkomt met editorconfig
de instellingen voor witruimte.
In dotnet format whitespace
de subopdracht worden alleen opmaakregels uitgevoerd die zijn gekoppeld aan witruimteopmaak. Zie de C#-opmaakopties voor een volledige lijst met mogelijke opmaakopties die u kunt opgeven in uw .editorconfig-bestand.
--folder
<PROJECT | SOLUTION>
Het argument behandelen als een pad naar een eenvoudige map met codebestanden.
dotnet format style
- Hiermee wordt code opgemaakt zodat deze overeenkomt met de EditorConfig-instellingen voor de codestijl.
In dotnet format style
de subopdracht worden alleen opmaakregels uitgevoerd die zijn gekoppeld aan codestijlopmaak. Zie Codestijlregels voor een volledige lijst met opmaakopties die u in uw editorconfig
bestand kunt opgeven.
--diagnostics <DIAGNOSTICS>
Een door spaties gescheiden lijst met diagnostische id's die moeten worden gebruikt als filter bij het oplossen van problemen met de codestijl. De standaardwaarde is de id's die worden vermeld in het .editorconfig-bestand . Voor een lijst met ingebouwde regel-id's voor codestijlanalyse die u kunt opgeven, raadpleegt u de lijst met id's voor regels voor codeanalyse.
--severity
De minimale ernst van diagnostische gegevens die moet worden opgelost. Toegestane waarden zijn
info
,warn
enerror
. De standaardwaarde iswarn
.
dotnet format analyzers
- Hiermee wordt code opgemaakt zodat deze overeenkomt met editorconfig
instellingen voor analyses (met uitzondering van regels voor codestijlen).
De dotnet format analyzers
subopdracht voert alleen opmaakregels uit die zijn gekoppeld aan analysen. Zie Kwaliteitsregels voor een lijst met analyseregels die u in uw editorconfig
bestand kunt opgeven.
--diagnostics <DIAGNOSTICS>
Een door spaties gescheiden lijst met diagnostische id's die moeten worden gebruikt als filter bij het oplossen van problemen met niet-codestijlen. De standaardwaarde is de id's die worden vermeld in het .editorconfig-bestand . Zie de lijst met id's voor kwaliteitsregels voor een lijst met ingebouwde regel-id's die u kunt opgeven. Raadpleeg hun documentatie voor analyse van derden.
--severity
De minimale ernst van diagnostische gegevens die moet worden opgelost. Toegestane waarden zijn
info
,warn
enerror
. De standaardwaarde iswarn
.
Alle code in de oplossing opmaken:
dotnet format ./solution.sln
Alle code in het toepassingsproject opschonen:
dotnet format ./src/application.csproj
Controleer of alle code correct is opgemaakt:
dotnet format --verify-no-changes
Alle code opschonen in de map src en tests , maar niet in src/submodule-a:
dotnet format --include ./src/ ./tests/ --exclude ./src/submodule-a/
Probleem met een specifieke codestijl oplossen:
dotnet format style --diagnostics IDE0005 --severity info
Los alle codestijlproblemen op met ernst
info
ofwarning
error
:dotnet format style --severity info
Los een specifiek analyseprobleem (niet-codestijl) op:
dotnet format analyzers --diagnostics CA1831 --severity warn
Los alle problemen met niet-codestijl op met ernst
info
oferror
warning
:dotnet format analyzers --severity info
.NET-feedback
.NET is een open source project. Selecteer een koppeling om feedback te geven: