C#の#errorディレクティブと#warningディレクティブの使い方を徹底解説

C#には、コンパイル時に独自のエラーや警告を発生させるためのプリプロセッサディレクティブとして、#errorと#warningが用意されています。この記事では、それぞれのディレクティブの役割と具体的な使い方をサンプルコード付きで解説します。

#errorディレクティブとは

#errorディレクティブを使用すると、コード内の特定の場所から意図的にコンパイルエラーを発生させることができます。主に、特定のシンボルが定義されていない場合などに、ビルドを強制的に中断させて開発者に通知したい場面で活用されます。

サンプルコード

using System;

namespace Demo {
    class Program {
        public static void Main(string[] args) {
            #if (!ONE)
            #error ONE is undefined
            #endif
            Console.WriteLine("Generating a user-defined error!");
        }
    }
}

上記のプログラムでは、シンボル「ONE」が定義されていない場合に#errorディレクティブが評価され、ユーザー定義のエラーが発生します。

実行結果（出力）

Compilation failed: 1 error(s), 0 warnings
error CS1029: #error: 'ONE is undefined'

このように、条件付きコンパイル（#if〜#endif）と組み合わせることで、必要なシンボルが未定義のままビルドされるのを防ぐことができます。

#warningディレクティブとは

#warningディレクティブを使用すると、コード内の特定の場所からレベル1の警告を生成できます。#errorと異なり、警告が出力されてもコンパイルは続行され、プログラムは正常に実行されます。

サンプルコード

using System;

namespace Demo {
    class Program {
        public static void Main(string[] args) {
            #if (!TWO)
            #warning TWO is undefined
            #endif
            Console.WriteLine("Generates a warning!");
        }
    }
}

上記のプログラムでは、シンボル「TWO」が定義されていない場合に警告が生成されますが、その後のコードも引き続き実行されます。

実行結果（出力）

warning CS1030: #warning: `TWO is undefined'
Generates a warning!

#errorと#warningの使い分けのポイント

• #error：必須のシンボルや設定が欠けている場合など、ビルドを続行すべきでない状況で使用します。
• #warning：非推奨のコードや注意が必要な箇所など、開発者へ通知しつつビルドは許可したい場合に使用します。

両ディレクティブとも条件付きコンパイルと組み合わせることで、プロジェクトの構成ミスを早期に検出できるため、大規模開発における品質管理にも役立ちます。