dotnet biçimi
Bu makale şunlar için geçerlidir: ✔️ .NET 6.x SDK ve sonraki sürümler
dotnet format
- Kodu ayarlarla eşleşecek şekilde editorconfig
biçimlendirin.
dotnet format [<PROJECT | SOLUTION>] [command] [options]
dotnet format -h|--help
dotnet format
, stil tercihlerini ve statik analiz önerilerini bir projeye veya çözüme uygulayan bir kod biçimlendiricidir. Tercihler varsa bir .editorconfig dosyasından okunur, aksi takdirde varsayılan bir tercih kümesi kullanılır. Daha fazla bilgi için EditorConfig belgelerine bakın.
PROJECT | SOLUTION
Kod biçimlendirmesini çalıştırmak için MSBuild projesi veya çözümü. Bir proje veya çözüm dosyası belirtilmezse, MSBuild geçerli çalışma dizininde proj veya sln ile biten dosya uzantısına sahip bir dosya arar ve bu dosyayı kullanır.
Komutun başarılı olması için dotnet format
aşağıdaki seçeneklerden hiçbiri gerekli değildir, ancak bunları hangi biçimlendirilmiş ve hangi kurallara göre daha fazla özelleştirmek için kullanabilirsiniz.
--diagnostics <DIAGNOSTICS>
Kod stili veya üçüncü taraf sorunları düzeltirken filtre olarak kullanılacak tanılama kimliklerinin boşlukla ayrılmış listesi. Varsayılan değer, .editorconfig dosyasında listelenen kimliklerdir. Belirtebileceğiniz yerleşik çözümleyici kuralı kimliklerinin listesi için kod çözümleme stili kurallarının kimlik listesine bakın.
--severity
Düzeltilmesi gereken tanılamaların en düşük önem derecesi. İzin verilen değerler ,
warn
veerror
değerleridirinfo
. Varsayılan değer şudur:warn
.--no-restore
Biçimlendirmeden önce örtük geri yükleme yürütmez. Varsayılan, örtük geri yükleme yapmaktır.
--verify-no-changes
Biçimlendirme değişikliği gerçekleştirilmeyeceğini doğrular. Herhangi bir dosya biçimlendirilmiş olsaydı sıfır olmayan bir çıkış koduyla sonlandırılır.
--include <INCLUDE>
Biçimlendirmeye eklenecek göreli dosya veya klasör yollarının boşlukla ayrılmış listesi. Varsayılan değer çözümdeki veya projedeki tüm dosyalardır.
--exclude <EXCLUDE>
Biçimlendirmenin dışında tutulacak göreli dosya veya klasör yollarının boşlukla ayrılmış listesi. Varsayılan değer none'dır.
--include-generated
SDK tarafından oluşturulan dosyaları biçimlendirin.
-v|--verbosity <LEVEL>
Ayrıntı düzeyini ayarlar. İzin verilen değerler ,
m[inimal]
,n[ormal]
,d[etailed]
vediag[nostic]
değerleridirq[uiet]
. Varsayılan değerm[inimal]
olarak belirlenmiştir.--binarylog <BINARY-LOG-PATH>
Tüm proje veya çözüm yükleme bilgilerini ikili günlük dosyasına kaydeder.
--report <REPORT-PATH>
tarafından
<REPORT_PATH>
belirtilen dizinde bir JSON raporu oluşturur.-h|--help
Yardım ve kullanım bilgilerini gösterir
dotnet format whitespace
- Kodu boşluk ayarlarıyla eşleşecek editorconfig
şekilde biçimlendirin.
Alt dotnet format whitespace
komut yalnızca boşluk biçimlendirmesiyle ilişkili biçimlendirme kurallarını çalıştırır. .editorconfig dosyanızda belirtebileceğiniz olası biçimlendirme seçeneklerinin tam listesi için C# biçimlendirme seçeneklerine bakın.
--folder
bağımsız değişkenini
<PROJECT | SOLUTION>
basit bir kod dosyaları klasörünün yolu olarak değerlendirin.
dotnet format style
- Kodu, kod stili için EditorConfig ayarlarıyla eşleşecek şekilde biçimlendirin.
Alt dotnet format style
komut yalnızca kod stili biçimlendirmesiyle ilişkili biçimlendirme kurallarını çalıştırır. Dosyanızda editorconfig
belirtebileceğiniz biçimlendirme seçeneklerinin tam listesi için bkz . Kod stili kuralları.
--diagnostics <DIAGNOSTICS>
Kod stili sorunlarını düzeltirken filtre olarak kullanılacak tanılama kimliklerinin boşlukla ayrılmış listesi. Varsayılan değer, .editorconfig dosyasında listelenen kimliklerdir. Belirtebileceğiniz yerleşik kod stili çözümleyici kuralı kimliklerinin listesi için kod çözümleme stili kurallarının kimlik listesine bakın.
--severity
Düzeltilmesi gereken tanılamaların en düşük önem derecesi. İzin verilen değerler ,
warn
veerror
değerleridirinfo
. Varsayılan değer:warn
dotnet format analyzers
- Kod, çözümleyicilerin ayarlarıyla eşleşecek editorconfig
şekilde biçimlendirildi (kod stili kuralları hariç).
Alt dotnet format analyzers
komut yalnızca çözümleyicilerle ilişkili biçimlendirme kurallarını çalıştırır. Dosyanızda editorconfig
belirtebileceğiniz çözümleyici kurallarının listesi için bkz . Kalite kuralları.
--diagnostics <DIAGNOSTICS>
Kod stili olmayan sorunları düzeltirken filtre olarak kullanılacak tanılama kimliklerinin boşlukla ayrılmış listesi. Varsayılan değer, .editorconfig dosyasında listelenen kimliklerdir. Belirtebileceğiniz yerleşik çözümleyici kuralı kimliklerinin listesi için kalite kuralları kimlikleri listesine bakın. Üçüncü taraf çözümleyiciler için belgelerine bakın.
--severity
Düzeltilmesi gereken tanılamaların en düşük önem derecesi. İzin verilen değerler ,
warn
veerror
değerleridirinfo
. Varsayılan değer şudur:warn
.
Çözümdeki tüm kodları biçimlendirin:
dotnet format ./solution.sln
Uygulama projesindeki tüm kodları temizleyin:
dotnet format ./src/application.csproj
Tüm kodun doğru biçimlendirildiğini doğrulayın:
dotnet format --verify-no-changes
src ve tests dizinindeki tüm kodları temizleyin, ancak src/submodule-a içinde temizlemeyin:
dotnet format --include ./src/ ./tests/ --exclude ./src/submodule-a/
Belirli bir kod stili sorununu düzeltin:
dotnet format style --diagnostics IDE0005 --severity info
Önem derecesi
info
warning
olan tüm kod stili sorunlarını düzeltin veyaerror
:dotnet format style --severity info
Belirli bir (kod stili olmayan) çözümleyici sorunu düzeltildi:
dotnet format analyzers --diagnostics CA1831 --severity warn
Önem derecesi
info
warning
olan tüm kod stili olmayan sorunları düzeltin veyaerror
:dotnet format analyzers --severity info
.NET geri bildirimi
.NET, açık kaynak bir projedir. Geri bildirim sağlamak için bir bağlantı seçin: