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:
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.
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.