C# コンパイラ エラー CS1560 の原因と対策について解説

CS1560は、C#のコンパイル時に発生するエラーで、#lineディレクティブに指定されたファイル名が無効な場合に表示されます。

例えば、ファイル名が256文字を超えたり、対象行が2000文字以上であった場合にこのエラーが起こります。

対策として、ファイル名や行の長さを見直す必要があります。

エラー発生の原因

プリプロセッサディレクティブに起因する問題

#lineディレクティブの仕様と制限

C#では、デバッグやエラーメッセージにおけるファイル名や行番号を操作するために、#lineディレクティブが利用されます。

このディレクティブは、意図的にエラーメッセージでの位置情報を変更できる便利な機能ですが、ファイル名や行番号の指定にいくつかの制限があるため、注意が必要です。

指定するファイル名が規定の文字数(詳細は下記の「ファイル名の長さ制限 (_MAX_PATH)」参照)を超える場合や、1行あたりの文字数の上限(下記の「行の文字数制限 (2000文字の上限)」)を超えると、コンパイラ エラー CS1560 が発生します。

ファイル名の長さ制限 (_MAX_PATH)

_MAX_PATHは通常、ファイル名の最大文字数として約256文字の制限があります。

つまり、#lineディレクティブで指定するファイル名が、この文字数を超えるとエラーとなります。

このため、デバッグ情報を出力する際はファイル名が短く、シンプルになるよう配慮する必要があります。

実際の環境では、システムやツールによってはこの制限に対してさらに厳しいルールが適用される場合もあります。

行の文字数制限 (2000文字の上限)

#lineディレクティブが存在する1行あたりの文字数についても制限があり、2000文字を超えるとエラーが発生します。

長いファイルパスや多数の追加情報を同一行に記述する場合、見落としがちな制限となります。

1行に含めるテキストが多くなりすぎないよう、コードの可読性と制限の両面から考慮する必要があります。

ソースコード記述における注意点

不適切なファイル名指定例

#lineディレクティブを用いる際に、以下のようなファイル名を指定するとCS1560エラーが発生します。

• ファイル名が256文字を超えている場合
• 使用できない文字や形式が含まれている場合

具体例として、以下のような不適切な記述が挙げられます。

#line 21 "MyFile1234567890MyFile1234567890MyFile1234567890MyFile1234567890MyFile1234567890MyFile1234567890MyFile1234567890MyFile1234567890.txt"

このように、冗長なファイル名や無意味に長い文字列は、後々のエラーの原因となるため、適正な命名規則を採用することが大切です。

エラー対応と修正方法

ファイル名の修正方法

_MAX_PATH制限を考慮した命名方法

ファイル名を短く保つためには、簡潔かつ意味のある名前を採用することが推奨されます。

例えば、デバッグ用の情報が必要な場合でも、余分な文字列を省略し、必要最低限の情報で構成するようにしましょう。

具体的には、ファイル名の命名規則として以下の点に注意してください。

• ファイル名は256文字以内に収める
• 特殊文字や記号を極力使用しない
• 冗長な部分は削除する

このような命名方法を採用することで、CS1560エラーの発生を防ぐことができます。

#lineディレクティブの適正な利用

正しいファイル名と行番号の指定方法

#lineディレクティブでは、正確なファイル名と行番号を設定する必要があります。

正しい利用例としては、次のような記述が考えられます。

#line 100 "MyFile.cs"

ここで、100は次に続くコードが本来存在する行番号を示し、"MyFile.cs"はエラーメッセージやデバッグ出力に正確に反映されるファイル名を表します。

誤った指定方法としては、ファイル名や行番号に余計なスペースや特殊な記号を含めることが挙げられます。

ソースコード全体の確認

記述ルールの調整

エラー発生後は、ソースコード全体を確認し、#lineディレクティブの利用方法や記述ルールが正しいかどうかを見直してください。

具体的には、以下の点をチェックすることが有効です。

• 各#lineディレクティブのファイル名が256文字以内であるか
• 1行あたりの文字数が2000文字を超えていないか
• 複数の#lineディレクティブが連続して使用されていないか

コード全体の記述ルールを調整することで、予期せぬエラーの再発を防ぐことが可能です。

コード事例と検証

エラー発生例のコード分析

問題となるコード例の詳細

以下は、CS1560エラーが発生する例です。

コード内で冗長なファイル名を#lineディレクティブに指定しているため、コンパイル時にエラーが発生します。

using System;
class Program
{
    public static void Main()
    {
        // 通常の出力
        Console.WriteLine("Normal line #1.");
        // エラーを引き起こす#lineディレクティブ
        #line 21 "MyFile1234567890MyFile1234567890MyFile1234567890MyFile1234567890MyFile1234567890MyFile1234567890MyFile1234567890MyFile1234567890.txt"
        Console.WriteLine("This line is affected by the #line directive.");
    }
}

エラー: コンパイラ エラー CS1560
プリプロセッサ ディレクティブに対して無効なファイル名が指定されました。

修正後のコード例

正しい記述方法のサンプル

以下は、上記のエラーを解消するために、ファイル名を簡潔に修正した例です。

_MAX_PATHの制限内に収まる適切なファイル名を指定することで、エラーが発生しなくなります。

using System;
class Program
{
    public static void Main()
    {
        // 通常の出力
        Console.WriteLine("Normal line #1.");
        // 修正済みの#lineディレクティブ
        #line 21 "MyFile.cs"
        Console.WriteLine("This line is now using a proper #line directive.");
    }
}

Normal line #1.
This line is now using a proper #line directive.

まとめ

この記事では、C#のコンパイラエラーCS1560の原因や対策が理解できます。

主に、#lineディレクティブの仕様上の制限として、ファイル名の長さ(_MAX_PATH：256文字以内)や1行あたりの文字数(2000文字上限)があり、これらを超えるとエラーが発生する原因となることを解説しています。

さらに、適切なファイル命名と記述ルールの調整により、エラーを防ぐ具体的な手法が学べます。