CS801～2000

C#コンパイラエラーCS1517の原因と対策を解説

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

C#のCS1517エラーは、無効なプリプロセッサ式が原因で発生します。

例えば、#if 1や#if *などの不正な式を使うとエラーとなります。

正しい例としては、#if symbolや#if trueなどがあり、適切なディレクティブに修正することで解決できます。

目次から探す

エラーCS1517の基本情報
- プリプロセッサディレクティブの役割
- エラー発生の原因
有効なプリプロセッサ式と不正な記述例
- 正しい式の記述方法
- 無効な記述パターン
エラー修正の対処方法
- コード点検と修正手順
- 開発環境での検証方法
まとめ

エラーCS1517の基本情報

C# コンパイラでエラー CS1517 は「無効なプリプロセッサの式」が原因で発生するエラーです。

コンパイラがプリプロセッサディレクティブの記述内容を解析する際、使用できない式が含まれているとこのエラーが出ます。

原因となる記述パターンを理解することで、修正がしやすくなります。

プリプロセッサディレクティブの役割

プリプロセッサディレクティブは、コードの条件付きコンパイルやコードの一部をコンパイルから除外するために使用されます。

たとえば、#if や #endif を用いて特定のシンボルが定義されているかどうかにより、コードのある部分だけを有効にすることができます。

これにより、実行環境ごとに異なる設定や機能の切り替えが可能になります。

エラー発生の原因

コンパイラエラー CS1517 が発生する理由は、プリプロセッサディレクティブに無効な式が書かれている場合です。

以下に、具体的な無効な式と正しい式の例を示します。

無効な式の記述例

以下の例は無効なプリプロセッサの式とみなされ、エラー CS1517 が発生します。

#if 1

数値リテラルはプリプロセッサディレクティブ内では使用できません。

#if ~symbol

演算子の使用が許可されていないため、無効です。

#if *

特殊記号の誤用にあたります。

これらの例では、コンパイラは条件を正しく評価できず、エラーとして報告します。

正しい式との比較

正しい式の場合、使用できる値や記述方法が限定されています。

以下の例は正しいと認識されるパターンです。

#if symbol

シンボル名だけを使い、定義されているかどうかで評価されます。

#if true や #if false

真偽値リテラルを直接使用する場合は、正しく評価されます。

括弧を使った記述も許容され、例えば #if (symbol) のような書き方も可能です。

これにより、明確な条件下でのコードの有効化が実現され、予期せぬエラーが発生しにくくなります。

有効なプリプロセッサ式と不正な記述例

プリプロセッサディレクティブで正しい式を使うためには、使用可能な記述方法と禁じられている記述パターンを把握することが重要です。

以下で、それぞれの記述方法について詳しく解説します。

正しい式の記述方法

正しいプリプロセッサの式では、シンボル名や真偽値、括弧によるグループ化が推奨されます。

たとえば、以下のような記述は適切です。

例：#if symbol, #if true, #if false の使用例

以下は正しい使用例です。

// 正しい例：シンボルの存在を確認
#if FEATURE_ENABLED
Console.WriteLine("機能が有効です。");
#endif
// 正しい例：真偽値リテラルの使用
#if true
Console.WriteLine("このコードは常に実行されます。");
#endif
// 正しい例：偽のリテラル使用
#if false
Console.WriteLine("このコードは実行されません。");
#endif
public class Program
{
    public static void Main()
    {
        // サンプルコードの実行部分
        #if FEATURE_ENABLED
        Console.WriteLine("機能が有効です。");
        #endif
        #if true
        Console.WriteLine("このコードは常に実行されます。");
        #endif
    }
}

機能が有効です。
このコードは常に実行されます。

無効な記述パターン

不正な記述パターンには、数値リテラルや特殊記号の誤用があります。

これらはプリプロセッサディレクティブ内では認識されず、エラーを引き起こします。

数値や特殊記号の誤用によるエラー

以下の例はエラー CS1517 を発生させる無効な記述例です。

// エラー例：数値リテラルの使用
#if 1
Console.WriteLine("数値リテラルは無効です。");
#endif
// エラー例：特殊記号の使用
#if *
Console.WriteLine("特殊記号の使用は無効です。");
#endif
// エラー例：ビット単位の否定演算子使用
#if ~FEATURE_ENABLED
Console.WriteLine("無効な演算子の使用によるエラーです。");
#endif
public class InvalidExample
{
    public static void Main()
    {
        // 不正記述のためコンパイルエラーになります
        #if 1
        Console.WriteLine("数値リテラルは無効です。");
        #endif
    }
}

これらのコードはC#コンパイラが認識できない式を含むため、必ずエラーが発生します。

エラー修正の対処方法

プリプロセッサディレクティブの記述が正しくない場合、エラーメッセージから原因を特定して、コードの修正を行う必要があります。

以下に、エラー修正の基本的な手順と検証方法を解説します。

コード点検と修正手順

エラーメッセージが表示された場合、まずは指摘されている行や記述を重点的に点検します。

エラーメッセージからの原因特定

エラーメッセージには、無効な式が使われている旨の情報が含まれています。

たとえば「無効なプリプロセッサの式」というメッセージが出た場合、数値リテラルや特定の特殊記号など誤った記述がないか確認します。

シンボル名の誤りや不要な記述が混入していないかを注意深くチェックしてください。

修正箇所の抽出と書き換え

原因が特定できたら、正しい記述方法に従ってコードを書き換えます。

具体的には、数値リテラルをシンボルに変更するか、不要な演算子を取り除くことでエラーを回避します。

修正前と修正後の例を比較検討することで、問題解決につながります。

開発環境での検証方法

修正後、エラーが解消されたかどうかを開発環境で再度確認することが大切です。

以下に、検証の手順を示します。

コンパイル再実行による確認手順

コード修正後に、開発環境でプロジェクトをビルドしてください。
コンパイルエラーが解消されたか確認し、エラーメッセージが出なくなっているかチェックします。
サンプルコードの実行結果を確認して、意図した動作をしていることを確かめます。

以下は、修正後のサンプルコードの一例です。

// 修正後の正しい例：シンボルを正しく使用
#define FEATURE_ENABLED
public class ValidExample
{
    public static void Main()
    {
        // FEATURE_ENABLED が定義されている場合だけ実行されるコード
        #if FEATURE_ENABLED
        Console.WriteLine("機能が有効です。");
        #endif
        // 常に実行されるコード
        #if true
        Console.WriteLine("このコードは常に実行されます。");
        #endif
    }
}

機能が有効です。
このコードは常に実行されます。

修正後のコードはコンパイルエラーが発生せず、意図した通りに動作します。

エラーの原因となる記述を正しい形式に変更することで、CS1517 エラーの対処が完了します。

まとめ

この記事では、C#のコンパイラエラーCS1517の原因となる無効なプリプロセッサ式の誤記法を理解できます。

正しいプリプロセッサディレクティブの記述方法、無効な例との比較、エラーメッセージをもとに原因を特定し修正する具体的な手順、そして修正後の検証方法をサンプルコードとともに学べます。