レベル1

C# コンパイラ警告 CS3003 の原因と対策を解説

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

CS3003 警告は、AssemblyにCLS準拠の設定を行っている場合に、publicやprotectedで宣言された変数の型が共通言語仕様に沿っていないと表示される警告です。

例えば、ushort型のようにCLS非準拠の型を使うと、この警告が出ることがあります。

目次から探す

原因の解説
発生事例とコード例
- ushort型を用いた具体例
- エラー出力の概要
対策の解説
- 型修正による解決方法
- 開発環境での確認手順
補足情報
- 関連コンパイラ警告との比較
- Microsoftドキュメントの参照ポイント
まとめ

原因の解説

CLS準拠の基本

共通言語仕様 (CLS) は、.NET環境で複数の言語間で相互運用性を確保するための仕様です。

CLSは各プログラミング言語が共通してサポートすべき最低限の機能と型を定義しており、CLS準拠のコードを書くことで異なる言語間で安全に利用できるライブラリを作成することができます。

公開変数における型の要求

公開(public)、保護(protected)、およびprotected internalなメンバーには、CLS準拠の型が要求されます。

たとえば、ushortやuintといった符号なし整数型はCLS非準拠の型であるため、これらを公開メンバーとして使用すると、コンパイラが警告を発生させます。

この要件は、ライブラリの利用者が複数の言語環境で同じAPIを利用する際に問題が生じないようにするためです。

警告CS3003発生の条件

警告CS3003は、CLS準拠属性 [assembly: CLSCompliant(true)] が付与されている状態で、公開メンバーに対してCLS非準拠の型が使用される場合に発生します。

具体的には、以下の条件が当てはまると警告が出ます。

・アセンブリ全体または対象クラスにCLS準拠属性が設定されている

・公開変数、プロパティ、メソッドのパラメータまたは戻り値にCLS非準拠の型(例: ushort)が使用されている

発生事例とコード例

ushort型を用いた具体例

以下のサンプルコードは、CLS準拠属性が付与されているアセンブリ内で、ushort を公開変数として使用する例です。

このコードでは、ushort型がCLS非準拠なため、コンパイル時に警告CS3003が発生します。

using System;
[assembly: CLSCompliant(true)]
public class SampleClass
{
    // public 変数に符号なし整数型を使用しているため、警告CS3003が発生します
    public ushort nonCompliantValue = 100;
    public static void Main()
    {
        Console.WriteLine("警告CS3003が発生する例です。");
    }
}

警告CS3003: 'SampleClass.nonCompliantValue' の型は CLS に準拠していません。

エラー出力の概要

コンパイラから出力されるエラーは以下のような内容です。

警告コード：CS3003
内容：『変数の型は CLS に準拠していません。』

エラーメッセージには、どの変数が問題となっているかの情報が含まれるため、コードのどの部分に修正が必要かを判断する手がかりとなります。

対策の解説

型修正による解決方法

公開メンバーにはCLS準拠の型を使用することで、警告CS3003を回避できます。

たとえば、ushortの代わりにCLS準拠な型であるshortを使用する方法が一般的です。

ただし、型変更に伴い、数値の範囲や符号に注意が必要です。

たとえば、元の型 ushort は $0 \leq x \leq 65535$ の範囲ですが、 short は $- 32768 \leq x \leq 32767$ の範囲となります。

CLS準拠型への置換例

次のサンプルコードは、非準拠のushortをCLS準拠のshortに変更した例です。

この変更により、コンパイラ警告は解消されます。

using System;
[assembly: CLSCompliant(true)]
public class SampleClass
{
    // 修正後: public変数の型をCLS準拠のshortに変更
    public short compliantValue = 100;
    public static void Main()
    {
        Console.WriteLine("CLS準拠型への置換例です。");
    }
}

CLS準拠型への置換例です。

変更時の留意点

型を変更する際は、以下の点に注意してください。

・値の範囲：short型はushort型に比べて表現可能な数値の範囲が狭くなるため、予期しない値のオーバーフローが発生しないように確認する必要があります。

・符号の有無：ushortは符号なしですが、shortは符号付きであるため、負の値が扱われる可能性があります。

・既存のロジック：型変更が他の部分に影響を与えないか、システム全体の動作を十分に確認する必要があります。

開発環境での確認手順

開発環境で修正の効果を確認するための手順は以下の通りです。

使用中のIDEやエディタでプロジェクトを開く
対象のコードを修正後、プロジェクト全体をビルドする
ビルド出力ウィンドウや警告リストで警告CS3003が解消されているか確認する
実行して、動作に問題がないか検証する

これらの手順により、型変更による副作用がないかどうかも合わせて確認できます。

補足情報

Microsoftドキュメントの参照ポイント

Microsoftの公式ドキュメントには、CLS準拠の詳細や警告CS3003に関する情報がわかりやすく解説されています。

特に、CLS準拠については「言語への非依存性、および言語非依存コンポーネント」の節を参照すると、複数の言語間での互換性確保の方法について理解が深まります。

また、ドキュメントに記載されている具体例やベストプラクティスも、実際の開発に役立つ内容となっています。

まとめ

本記事では、.NETの共通言語仕様 (CLS) に関する基本知識と、公開メンバーで認められる型の要求について解説しています。

警告CS3003が発生する条件や、ushort型を使用した場合の具体例とエラーメッセージを示し、代替としてCLS準拠型であるshortへの置換例や変更時の注意点を説明しています。

また、開発環境での確認手順や関連警告、Microsoftドキュメントの参照ポイントも紹介しています。