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

Özellik	Değer
Kural Kimliği	CA1812
Başlık	Nesnesi oluşturulmamış iç sınıflardan kaçının
Kategori	Performans
Düzeltme bozucu ya da bozmayan olabilir	Kesintisiz
.NET 10'da varsayılan olarak etkin	Hayır
Geçerli diller	C# ve Visual Basic

Neden

İç (derleme düzeyi) türü hiçbir zaman örneklenmez.

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
• Örneklenemeyen ve yalnızca yöntemler tanımlayan static türler.

Çözümlenen derlemeye uygularsanız, varsayılan olarak bir alanın bir arkadaş derlemesi tarafından kullanılabileceği için, Visual Basic'te olarak () işaretlenmiş türleri bu kural işaretlemez. 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:

• sınıfı gibi System.Activator.CreateInstancegeç bağlı yansıma yöntemleriyle oluşturulur.

• sınıfı, bağımlılık ekleme deseninin bir parçası olarak bir inversion of control (IoC) kapsayıcısında kaydedilir.

• sınıfı çalışma zamanı veya ASP.NET tarafından otomatik olarak oluşturulur. Otomatik olarak oluşturulan sınıflara bazı örnekler, System.Configuration.IConfigurationSectionHandler veya System.Web.IHttpHandler uygulayan sınıflardır.

• sınıfı, bir sınıf tanımında tür parametresi olarak kullanılır ve bir new kısıtlaması vardır. Aşağıdaki örnek CA1812 kuralı tarafından işaretlenir.

  internal class MyClass
  {
      public void DoSomething()
      {
      }
  }
  public class MyGeneric<T> where T : new()
  {
      public T Create()
      {
          return new T();
      }
  }
  
  MyGeneric<MyClass> mc = new MyGeneric<MyClass>();
  mc.Create();
  

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.

Kod çözümleme için konfigüre et

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.

• InternalsVisibleTo özniteliğini görmezden gel

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ği görmezden gel

Analiz edilen derleme, iç simgelerini açığa çıkarmak için InternalsVisibleToAttribute kullanıyorsa, varsayılan olarak bu kural devre dışı bırakılır. Yapılandırmayı değiştirmek için ignore_internalsvisibleto seçeneğini ayarlayabilirsiniz. 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

Not

XXXX CAXXXX bölümünü geçerli kuralın kimliğiyle değiştirin.

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

İlgili kurallar

• CA1801: Kullanılmayan parametreleri gözden geçir