CA1014: Derlemeleri CLSCompliantAttribute ile işaretleyin

Özellik Değer
Kural Kimliği CA1014
Başlık Bütünleştirmeleri CLSCompliantAttribute ile işaretle
Kategori Tasarım
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

Bir montajda System.CLSCompliantAttribute özniteliği uygulanmamış.

Kural açıklaması

Ortak Dil Tanımlaması (CLS), ad kısıtlamalarını, veri türlerini ve programlama dilleri arasında kullanılacak derlemelerin uyması gereken kuralları tanımlar. Tasarım gerektirir ki tüm derlemeler CLSCompliantAttributeCLS uyumluluğunu açıkça belirtir. Öznitelik bir derlemede yoksa, derleme uyumlu değildir.

CLS uyumlu bir derlemenin uyumlu olmayan türler veya tür üyeleri içermesi mümkündür.

İhlalleri düzeltme

Bu kuralın ihlalini düzeltmek için özniteliği derlemeye ekleyin. Derlemenin tamamını uyumsuz olarak işaretlemek yerine, hangi tür veya tür üyelerinin uyumlu olmadığını belirlemeniz ve bu öğeleri bu şekilde işaretlemeniz gerekir. Mümkünse, mümkün olan en geniş hedef kitlenin derlemenizin tüm işlevlerine erişebilmesi için uyumsuz üyeler için CLS uyumlu bir alternatif sağlamanız gerekir.

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

Bu kuraldan uyarıyı bastırmayın. Derlemenin uyumlu olmasını istemiyorsanız özniteliğini uygulayın ve değerini olarak falseayarlayın.

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

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.CA1014.severity = none

Daha fazla bilgi için bkz . Kod analizi uyarılarını gizleme.

Örnek

Aşağıdaki örnek, CLS uyumlu olduğunu ilan eden System.CLSCompliantAttribute özniteliğinin bir derlemeye uygulandığını göstermektedir.

[assembly:CLSCompliant(true)]
namespace DesignLibrary {}

<assembly:CLSCompliant(true)>
Namespace DesignLibrary
End Namespace

Ayrıca bkz.

  • Last updated on