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

Makale
11/12/2024

Özellik	Değer
Kural Kimliği	CA1852
Başlık	dahili türleri mühürleme
Kategori	Performans
Hataya neden olan veya bozulmayan düzeltme	Hataya neden olmayan
Tanıtılan sürüm	.NET 7
.NET 9'da varsayılan olarak etkin	Hayır

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şilemediyse ve içeren derlemesinde alt tür yoksa, güvenli bir şekilde kapatılabilir. Sızdırmazlık türleri performansı artırabilir. Daha fazla bilgi için bkz . Çözümleyici Teklifi: İç/özel türleri mühürleme].

Çö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ü (NotInheritable Visual Basic'te) olarak sealed işaretleyin.

Ö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 none olarak ayarlayın.

[*.{cs,vb}]
dotnet_diagnostic.CA1852.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.

Aracılığıyla paylaş