Aracılığıyla paylaş


CA1812: Örneklendirilmemiş iç sınıflardan kaçının

Özellik Değer
Kural Kimliği CA1812
Başlık Örneklenmemiş iç sınıflardan kaçının
Kategori Performans
Hataya neden olan veya bozulmayan düzeltme Hataya neden olmayan
.NET 8'de varsayılan olarak etkin Hayır

Neden

İç (derleme düzeyi) türü hiçbir zaman örnek oluşturmaz.

Kural açıklaması

Bu kural türün oluşturucularından birine yapılan çağrıyı bulmaya çalışır ve hiçbir çağrı bulunamazsa bir ihlal bildirir.

Aşağıdaki türler bu kural tarafından incelenmez:

  • Değer türleri
  • Soyut türler
  • Listelemeler
  • Temsilciler
  • Derleyici tarafından yayılan dizi türleri
  • Örneği oluşturulamaz ve yalnızca yöntemleri tanımlayan static türler.

Çözümlenen derlemeye uygularsanızSystem.Runtime.CompilerServices.InternalsVisibleToAttribute, bu kural varsayılan olarak (Friend Visual Basic'te) olarak internal işaretlenmiş türleri işaretlemez, çünkü bir alan bir arkadaş derlemesi tarafından kullanılabilir. Derlemeyi yine de analiz etmek için bkz . Çözümlemek için kod yapılandırma.

İhlalleri düzeltme

Bu kuralın ihlalini düzeltmek için türü kaldırın veya kullanan kodu ekleyin. Tür yalnızca static yöntemler içeriyorsa, derleyicinin static varsayılan bir genel örnek oluşturucu yaymasını önlemek için türüne değiştiriciyi ekleyin.

Uyarıların ne zaman bastırılması gerekiyor?

Bu kuraldan gelen bir uyarıyı engellemek güvenlidir. Aşağıdaki durumlarda bu uyarıyı gizlemenizi öneririz:

Uyarıyı gizleme

Yalnızca tek bir ihlali engellemek istiyorsanız, kuralı devre dışı bırakmak ve sonra yeniden etkinleştirmek için kaynak dosyanıza ön işlemci yönergeleri ekleyin.

#pragma warning disable CA1812
// The code that's violating the rule is on this line.
#pragma warning restore CA1812

Bir dosya, klasör veya projenin kuralını devre dışı bırakmak için, yapılandırma dosyasındaki önem derecesini noneolarak ayarlayın.

[*.{cs,vb}]
dotnet_diagnostic.CA1812.severity = none

Daha fazla bilgi için bkz . Kod analizi uyarılarını gizleme.

Çözümlemek için kod yapılandırma

Bu kuralın kod tabanınızın hangi bölümlerinde çalıştırılacaklarını yapılandırmak için aşağıdaki seçeneği kullanın.

Bu seçeneği yalnızca bu kural için, geçerli olduğu tüm kurallar için veya bu kategorideki (Performans) tüm kurallar için yapılandırabilirsiniz. Daha fazla bilgi için bkz . Kod kalitesi kuralı yapılandırma seçenekleri.

InternalsVisibleTo özniteliğini yoksay

Analiz edilen InternalsVisibleToAttribute derleme iç simgelerini kullanıma sunarsa varsayılan olarak bu kural devre dışı bırakılır. Derleme ile InternalsVisibleToAttributeişaretlenmiş olsa bile kuralın çalıştırılması gerektiğini belirtmek için projenizdeki bir .editorconfig dosyasına aşağıdaki anahtar-değer çiftini ekleyin:

dotnet_code_quality.CAXXXX.ignore_internalsvisibleto = true

Bu seçenek .NET 8'den itibaren kullanılabilir.