次の方法で共有

CA1014: アセンブリに CLSCompliantAttribute を設定します

  • [アーティクル]
プロパティ 値
ルール ID CA1014
Title アセンブリに CLSCompliantAttribute を設定します
[カテゴリ] デザイン
修正が中断ありか中断なしか なし
.NET 9 では既定で有効 いいえ

原因

アセンブリに System.CLSCompliantAttribute 属性が適用されていません。

規則の説明

共通言語仕様 (CLS) には、名前付けの制約、データ型、および規則が定義されています。アセンブリを複数のプログラミング言語で使用する場合、この仕様に準拠する必要があります。 すべてのアセンブリに CLSCompliantAttribute を使用して、CLS への準拠を明示することをお勧めします。 この属性が使用されていないアセンブリは準拠しません。

CLS 準拠のアセンブリに、準拠していない型または型のメンバーが含まれている可能性があります。

違反の修正方法

この規則違反を修正するには、この属性をアセンブリに適用します。 アセンブリ全体を非準拠としてマークするのではなく、準拠していない型または型のメンバーを判断し、これらの要素を非準拠としてマークする必要があります。 可能であれば、準拠していないメンバーに対して CLS 準拠の代替手段を提供して、可能な限り幅広い対象ユーザーがアセンブリのすべての機能にアクセスできるようにする必要があります。

どのようなときに警告を抑制するか

この規則による警告は抑制しないでください。 アセンブリを準拠させない場合は、この属性を適用し、その値を false に設定します。

警告を抑制する

単一の違反を抑制するだけの場合は、ソース ファイルにプリプロセッサ ディレクティブを追加して無効にしてから、規則をもう一度有効にします。

#pragma warning disable CA1014
// The code that's violating the rule is on this line.
#pragma warning restore CA1014

ファイル、フォルダー、またはプロジェクトの規則を無効にするには、構成ファイルでその重要度を none に設定します。

[*.{cs,vb}]
dotnet_diagnostic.CA1014.severity = none

詳細については、「コード分析の警告を抑制する方法」を参照してください。

例

次の例は、CLS 準拠を宣言する System.CLSCompliantAttribute 属性が適用されているアセンブリを示しています。

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

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

関連項目