Dil ve gereksiz kurallar

  • Makale

Kod stili dil kuralları, .NET programlama dillerinin çeşitli yapılarının (örneğin, değiştiriciler ve parantezler) nasıl kullanıldığını etkiler.

Bu kategori, kod tabanının gereksiz olan ve yeniden düzenlenebilen veya kaldırılabilir bölümlerini tanımlayan kuralları da içerir. Gereksiz kodun varlığı aşağıdaki sorunlardan birini daha gösterir:

  • Okunabilirlik: Okunabilirliği gereksiz yere düşüren kod.
  • Bakım: Yeniden düzenlemeden sonra artık kullanılmayan ve gereksiz yere korunan kod.
  • Performans: Yan etkisi olmayan ve gereksiz performans ek yüküne yol açan gereksiz hesaplama.
  • İşlevsellik: Kodda gerekli kodu yedekli hale getiren işlevsel sorun. Örneğin, IDE0060 yöntemin yanlışlıkla bir giriş parametresini yoksaydığı kullanılmayan parametreleri işaretler.

Dil kuralları aşağıdaki kategorilere ayrılır:

  • .NET stil kuralları: Hem C# hem de Visual Basic için geçerli kurallar. Bu kuralların seçenek adları ön ekiyle dotnet_style_başlar.
  • C# stili kuralları: C# koduna özgü kurallar. Bu kuralların seçenek adları ön ekiyle csharp_style_başlar.
  • Visual Basic stil kuralları: Visual Basic koduna özgü kurallar. Bu kuralların seçenek adları ön ekiyle visual_basic_style_başlar.

Seçenek biçimi

Dil kurallarının çoğunda tercih edilen stili özelleştirmek için bir veya daha fazla ilişkili seçenek vardır. Örneğin, Use simple 'using' deyimi (IDE0063), bir bildirimi mi yoksa using deyimi mi tercih using ettiğinizi tanımlamanızı sağlayan ilişkili seçeneğe csharp_prefer_simple_using_statement sahiptir. Kural, belirtilen düzeyde hangi seçenekleri seçerseniz (örneğin, uyarı veya hata) zorlar.

Dil kuralları seçenekleri aşağıdaki biçime sahip bir yapılandırma dosyasında belirtilebilir:

option_name = value (Visual Studio 2019 ve üzeri)

veya

option_name = value:severity

  • Value

    Her dil kuralı için, stilin ne zaman veya ne zaman tercihleneceğini tanımlayan bir değer belirtirsiniz. Birçok kural değerini true kabul eder (bu stili tercih eder) veya false (bu stili tercih etmeyin). Diğer kurallar veya nevergibi when_on_single_line değerleri kabul eder.

  • Önem derecesi (Visual Studio 2019 ve sonraki sürümlerde isteğe bağlı)

    Kuralın ikinci bölümü, kuralın önem düzeyini belirtir. .NET 9 ve sonraki sürümlerde önem derecesi her zaman dikkate alınmaktadır; yani geliştirme IDE'leri içinde ve komut satırı derlemeleri sırasında. .NET 8 ve önceki sürümlerde, bu önem derecesi ayarı derleme sırasında değil yalnızca Visual Studio gibi geliştirme IDE'leri içinde dikkate alır.

    .NET 8 SDK'sını veya önceki bir sürümü kullanıyorsanız ve önem derecesine derleme zamanında uyulmasını istiyorsanız, bunu iki yoldan biriyle yapabilirsiniz:

    • <AnalysisLevel> veya <AnalysisLevelStyle> özelliğini veya üzeri olarak 9.0 ya da olarak previewayarlayın.
    • Bunun yerine çözümleyiciler için kimlik tabanlı önem derecesi yapılandırma söz dizimini kullanarak önem derecesini ayarlayın. Söz dizimi biçimindedir dotnet_diagnostic.<rule ID>.severity = <severity>, örneğin, dotnet_diagnostic.IDE0040.severity = warning. Daha fazla bilgi için bkz . önem düzeyi.

İpucu

Visual Studio 2019'dan başlayarak, bir stil ihlali oluştuktan sonra Hızlı Eylemler ampul menüsünden kod stili kurallarını yapılandırabilirsiniz.

Kural dizini

Dil ve gereksiz kod kuralları, ifade düzeyi tercihleri, kod bloğu tercihleri ve değiştirici tercihler gibi alt kategorilere ayrılır.

using yönerge tercihleri

.NET stil kuralları (C# ve Visual Basic):

C# stil kuralları:

Kod bloğu tercihleri

C# stil kuralları:

İfade gövdeli üyeler

C# stil kuralları:

İfade düzeyinde tercihler

.NET stil kuralları (C# ve Visual Basic):

C# stil kuralları:

Visual Basic stil kuralları:

Alan tercihleri

.NET stil kuralları (C# ve Visual Basic):

Dil anahtar sözcüğü ile çerçeve türü tercihleri karşılaştırması

.NET stil kuralları (C# ve Visual Basic):

Değiştirici tercihleri

.NET stil kuralları (C# ve Visual Basic):

C# stil kuralları:

Yeni satır tercihleri

  • Birden çok boş satıra izin ver (IDE2000)
  • Aynı satırda eklenmiş deyimlere izin ver (IDE2001)
  • Ardışık ayraçlar arasında boş satırlara izin ver (IDE2002)
  • Blok sonrasında hemen allow deyimi (IDE2003)
  • Oluşturucu başlatıcısında iki nokta üst üste geçtikten sonra boş satıra izin ver (IDE2004)
  • Koşullu ifadede belirteç sonrasında boş satıra izin ver (IDE2005)
  • Ok ifadesinde belirteç sonrasında boş satıra izin ver (IDE2006)

Null denetleme tercihleri

C# stil kuralları:

Parametre tercihleri

.NET stil kuralları (C# ve Visual Basic):

Parantez tercihleri

.NET stil kuralları (C# ve Visual Basic):

Desen eşleştirme tercihleri

C# stil kuralları:

Gizleme tercihleri

.NET stil kuralları (C# ve Visual Basic):

This. ve me. tercihleri

.NET stil kuralları (C# ve Visual Basic):

var Tercihler

C# stil kuralları:

Ayrıca bkz.