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 9'da 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:

• 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 veya System.Web.IHttpHandleruygulayan System.Configuration.IConfigurationSectionHandler 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 bayrakla 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 none olarak 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.

• InternalsVisibleTo özniteliğini yoksay

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.

İlgili kurallar

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