【C#】CS1025エラーの原因と対処法：プリプロセッサディレクティブにおけるコメント記述の見直し

CS1025エラーは、C#のプリアプロセッサディレクティブの行で不正なコメント記述が原因で発生します。

例えば、複数行のコメントをディレクティブに混ぜると、単一行コメントまたは行末コメントの形式に従っていないため、このエラーが表示されます。

正しいコメント形式に修正することで、エラーを解消できます。

プリアプロセッサディレクティブの基本

C#におけるディレクティブの役割

C#のプリプロセッサディレクティブは、ソースコードのコンパイル前に条件付きコンパイルやコードのインクルード、除外などの指示を行うために使われます。

プログラム全体の動作に影響を与えるため、正しい書き方が求められます。

不要なトラブルを避けるためにも、ルールに沿って記述する必要があります。

コメント記述の基本ルール

C#では、コード内で注釈を残すためにコメント文を記述します。

主に二つの形式があり、それぞれに利用の注意点があります。

特にプリプロセッサディレクティブと一緒に使う場合、記述方法によってはエラーが発生することがあります。

単一行コメントと行末コメントの使い方

単一行コメントは、//を使って記述します。

行全体またはコードの末尾に書くことができ、プリプロセッサディレクティブと併用する場合も、その行に記述することで問題なく動作します。

以下のサンプルコードは、単一行コメントと行末コメントを用いた例です。

using System;
class Program {
    static void Main() {
        // ここは単一行コメントです
        Console.WriteLine("Hello World"); // この部分は行末コメントです
    }
}

Hello World

複数行コメントの制限

複数行コメントは、/*と*/で囲む表記が可能ですが、プリプロセッサディレクティブが書かれた行には記述できません。

この制限を無視すると、CS1025エラーが発生します。

複数行コメントは主に通常のコード部分で利用し、ディレクティブ内の場合はシングルラインコメントへの切り替えが推奨されます。

CS1025エラーの原因詳細

不正なコメント記述パターン

CS1025エラーは、プリプロセッサディレクティブにおいて不正なコメント表記が使われたときに発生します。

特に、複数行コメントをディレクティブ内に記述すると、期待される単一行コメントや行末コメントがないとしてコンパイルエラーにつながります。

プリアプロセッサディレクティブ内での複数行コメントの禁止

次のコードは、プリプロセッサディレクティブ内で複数行コメントが使われた場合の一例です。

このコードは、ディレクティブ内に複数行コメントがあるためにコンパイル時にエラーが発生してしまいます。

#define CONDITION
using System;
class Sample {
    static void Main() {
#if CONDITION /* マルチラインコメントの開始
の途中で改行して記述されているためエラーになります */
        Console.WriteLine("エラーが発生します");
#endif
    }
}

// コンパイルエラーが発生します: CS1025

無効なディレクティブ記述の例

不適切なシンタックスでディレクティブを書いてしまうことも、CS1025エラーの原因の一つです。

エラーが発生しやすい表記に注意する必要があります。

誤ったシンタックスによるエラー発生

以下のコードでは、プリプロセッサディレクティブの記述方法に誤りがあるためCS1025エラーが発生します。

ディレクティブとコードが正しく連動せず、無効なシンタックスと認識されてしまいます。

#define FLAG
using System;
class Program {
    static void Main() {
#if FLAG 1    // この記述は適切な書式になっていません
        Console.WriteLine("Hello World");
#endif
    }
}

// コンパイルエラーが発生します: CS1025

エラー解消の対処法

正しいコメント記述方法の適用

CS1025エラーを回避するためには、プリプロセッサディレクティブ内でのコメント記述は必ず単一行コメント//を使うように修正する必要があります。

これにより、コンパイラが適切にディレクティブを認識し、エラーを防ぐことが可能となります。

修正例コードの検証方法

次の正しい記述のサンプルコードは、適切なコメント記述を利用してエラーが発生しない状態に修正したものです。

ディレクティブ内のコメントはすべて//を利用して記述されています。

#define FLAG
using System;
class Program {
    static void Main() {
#if FLAG // コメントは単一行で記述しています
        Console.WriteLine("正しく動作します");
#endif
    }
}

正しく動作します

動作確認の検証ポイント

修正内容の検証は、コンパイルと実際の実行結果を確認することで行えます。

以下のポイントに注意してチェックを行ってください。

修正前後の比較チェック

• 修正前
  • プリプロセッサディレクティブ内で複数行コメントを使用してCS1025エラーが発生する状態
  • 不正なシンタックスによるエラーが確認されます
• 修正後
  • ディレクティブ内のコメントがすべて//で記述され、コンパイルエラーが解消されます
  • 実行時に期待通りの出力が得られることを確認

まとめ

今回の記事では、C#のプリプロセッサディレクティブとコメント記述に関する基本的なルールやCS1025エラーが発生する原因について解説しました。

エラーの主な原因は、ディレクティブ内での複数行コメントや不正なシンタックスによるものです。

正しい単一行コメントの利用を心がけることで、エラーを回避できるため、修正後のコードの動作確認を行いながら、丁寧に記述を見直すとよいでしょう。