CA1852: İç türleri mühürleme

Özellik Değer
Kural Kimliği CA1852
Başlık dahili türleri mühürleme
Kategori Performans
Düzeltme bozucu ya da bozmayan olabilir Kesintisiz
Tanıtılan sürüm .NET 7
.NET 10'da varsayılan olarak etkin Hayır
Geçerli diller C# ve Visual Basic

Neden

Derlemesi dışında erişilmeyen ve içeren derlemesinde alt türü olmayan bir tür işaretlenmez sealed (NotInheritable Visual Basic'te).

Kural açıklaması

Bir tür derlemesi dışından erişilemiyorsa ve kendi derlemesinde alt türü yoksa, güvenli bir şekilde mühürlenebilir. Sızdırmazlık türleri performansı artırabilir. Daha fazla bilgi için bkz: Analyzer Teklifi: İç/özel türleri kapatma.

Çözümlenen derlemeye uygularsanız System.Runtime.CompilerServices.InternalsVisibleToAttribute , bu kural varsayılan olarak sealed işaretlenmemiş 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

Türü sealed olarak işaretleyin (NotInheritable Visual Basic'te).

Örnek

Aşağıdaki kod parçacığı CA1852 ihlalini gösterir:

internal class C
{ }

Class C
End Class

Aşağıdaki kod parçacığı ihlali düzeltir:

internal sealed class C
{ }

NotInheritable Class C
End Class

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

Performans önemli değilse uyarıyı bastırmak güvenlidir.

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 CA1852
// The code that's violating the rule is on this line.
#pragma warning restore CA1852

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

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.

  • Last updated on