レベル1

C# コンパイラ警告 CS3013 について解説 – CLSCompliant属性の整合性確認手順

2025-03-29更新日: 2025-03-29

CS3013は、C#のコンパイラ警告の一つです。

この警告は、追加されたモジュールのCLSCompliant属性と、現在のコンパイル設定が一致しない場合に表示されます。

たとえば、[module:CLSCompliant(true)]と指定している場合、プロジェクト設定もtrueになっている必要があります。

警告が解消できるよう設定を確認してください。

目次から探す

CS3013警告の概要と原因
- 警告の発生条件
- 警告メッセージの詳細
CLSCompliant属性の基本
- 属性の役割と目的
- 属性設定時の注意点
警告解消の対応策
- コンパイル設定の確認
- 設定修正の手順
まとめ

CS3013警告の概要と原因

CS3013警告は、追加されたモジュールのCLSCompliant属性とアセンブリ全体のCLSの状態が一致しない場合に表示されます。

この警告は、モジュールごとに指定されるCLSコンプライアンスの状態が、プロジェクト全体の設定と異なる場合に発生します。

そのため、プロジェクトに複数のモジュールが含まれる場合、各モジュールが正しいCLSCompliant属性で設定されているか確認する必要があります。

警告の発生条件

警告は、モジュール属性の設定状態とプロジェクトのCLS準拠状態の不整合により発生します。

正しい設定が行われていないと、モジュール追加時に自動的にCS3013警告が出力されます。

モジュール属性の設定状態

モジュールごには、CLSCompliant属性を使用してCLSへの準拠状態が指定されます。

具体的には、モジュールの先頭で以下のような記述が行われます。

[module:CLSCompliant(true)]

この属性は、モジュールがCLSに準拠していることを示すために利用されます。

逆に、モジュールがCLSに準拠していない場合は、以下のように指定されることがあります。

[module:CLSCompliant(false)]

これらの設定がプロジェクト全体のCLS設定と一致していないと、CS3013警告が発生する原因となります。

プロジェクトのCLS準拠状態

プロジェクト全体では、通常、アセンブリ情報にCLS準拠の指定が行われます。

例えば、AssemblyInfo.csなどで以下のように設定されることがあります。

[assembly:CLSCompliant(true)]

プロジェクトがCLSに準拠していると指定しているのに、モジュールの属性がfalseの場合、整合性が取れずにCS3013の警告が表示されます。

そのため、プロジェクト内の各モジュールで使用する属性とアセンブリ全体の設定が一致していることが重要です。

警告メッセージの詳細

警告メッセージには、「追加されたモジュールは、アセンブリに一致するように CLSCompliant 属性と共に設定されなければなりません」という文言が含まれます。

このメッセージは、モジュール属性とアセンブリ属性間に不一致があるときに表示されるため、速やかに設定の見直しが必要です。

また、警告には該当するモジュール名や、現在設定されている属性の状態が記載される場合があります。

CLSCompliant属性の基本

CLSCompliant属性は、コードが共通言語仕様 (CLS) に準拠しているかどうかを示すために使用されます。

共通言語仕様に準拠することで、他の言語と高い互換性が保たれ、ライブラリやコンポーネントの再利用性が向上します。

属性の役割と目的

CLSCompliant属性は、開発者が意図した通りにコードが他言語と連携できるよう、コンパイラに対して明示的に設定するためのものです。

属性を正しく設定することで、意図しない動作や互換性の問題を未然に防ぐことができます。

属性の指定方法

属性の指定は、通常ファイルの先頭に記述されます。

例えば、CLSに準拠している場合は以下のように記述します。

[module:CLSCompliant(true)]

アセンブリ単位で指定する場合は、以下のように記述されることもあります。

[assembly:CLSCompliant(true)]

[module:CLSCompliant(true)]と[module:CLSCompliant(false)]の違い

[module:CLSCompliant(true)]を指定すると、モジュール内のすべての型やメンバーがCLSに準拠している必要があります。

一方で、[module:CLSCompliant(false)]を指定すると、そのモジュールはCLS準拠が保証されないことを示します。

プロジェクト全体がCLS準拠である場合、モジュール単位でfalseを設定すると、整合性が保たれずにCS3013警告が発生するため注意が必要です。

属性設定時の注意点

属性設定の際は、以下の点に注意する必要があります。

プロジェクト全体のCLS準拠設定とモジュールごとの設定が一致しているか確認する
複数のモジュールが存在する場合、一部のモジュールだけ属性が異なると整合性エラーが発生する
CLS準拠性の設定は、コードの互換性に大きく関わるため、設定変更には慎重を期す

属性の設定が間違っていると、意図しない警告やエラーが表示され、コードの再利用性や他言語との連携に影響が出る可能性があるため、注意深く設定を行ってください。

警告解消の対応策

CS3013警告を解消するためには、コンパイル設定とプロジェクト内のCLSCompliant属性の整合性を正しく設定することが必要です。

具体的な解消手順を確認しながら、環境全体の設定を見直すことが解決の鍵となります。

コンパイル設定の確認

まずは、現在のコンパイル設定および属性の状態を確認します。

プロジェクトにおけるアセンブリ属性と各モジュールでの属性設定が一致しているかどうか、正確に把握してください。

プロジェクト設定とモジュール属性の整合性チェック

プロジェクト設定ファイル(例：AssemblyInfo.cs)と各モジュールで使用されているCLSCompliant属性が一致しているかをチェックします。

プロジェクト全体でCLS準拠がtrueに設定されている場合、すべてのモジュールにも同様の属性を設定する必要があります。

整合性が取れていない場合、以下のような手順で修正を行います。

プロジェクトファイルと各モジュールの属性を確認する
不一致が見つかった場合、属性値を統一する

設定修正の手順

正しい整合性を保つために、各モジュールの属性設定を必要に応じて変更します。

具体的な修正方法について以下に例を示します。

属性設定の変更方法

モジュールごとのCLSCompliant属性変更例として、以下のサンプルコードをご覧ください。

このサンプルでは、プロジェクト全体がCLS準拠であると仮定し、モジュールも同様にtrueで設定しています。

using System;
[assembly:CLSCompliant(true)] // アセンブリ全体のCLS準拠設定
// モジュール単位での設定(必要に応じて設定する)
[module:CLSCompliant(true)]
namespace SampleApp
{
    class Program
    {
        static void Main(string[] args)
        {
            // サンプル出力
            Console.WriteLine("CLS準拠属性の設定が統一されています。");
        }
    }
}

CLS準拠属性の設定が統一されています。

上記のサンプルコードでは、アセンブリおよびモジュールの両方にCLSCompliant(true)が指定されています。

プロジェクト全体の設定と一致するため、CS3013警告が発生することはありません。

実際のプロジェクトにおいては、プロジェクト設定にも注意を払いながら、このように属性を統一してください。

まとめ

本記事では、CS3013警告の原因であるモジュール属性とアセンブリ全体のCLSCompliant属性の不一致について解説しています。

警告が発生する理由、各属性の指定方法や設定上の注意点、整合性を確認して修正する手順が理解できます。

サンプルコードを通して、実際の修正方法が把握できる内容となっています。