【C#】プリプロセッサディレクティブ

プリプロセッサとは
コンパイルシンボル
デバッグのときのみ実行されるメソッドを定義する
意図的にコンパイルエラー/警告を出力する
エディターでグループを折りたたむ
警告を無効にする
今日の英単語

プリプロセッサとは

コンパイルの前に処理を行う機能。

プリプロセッサディレクティブは#defineなど#で始まる指示語。

コンパイルシンボル

デバッグビルドとリリースビルドで処理を分けたい場合などに使う。
コンパイルシンボルとは、#if , #elif #else #endifディレクティブと組み合わせて使うシンボル語のこと。
デフォルトでDEBUG（デバッグビルド）、RELEASE（リリースビルド）、TRACE（両方）のシンボルが用意されている。

デバッグビルド：デバッグに最適化された構成
リリースビルド：パフォーマンスに最適化された構成

独自にコンパイルシンボルを定義したい場合は#defineを使う。#defineはプログラムの先頭で、名前空間宣言当の他のキーワードの前に指定する必要がある。シンボルの定義を解除する場合は#undefを使う。
また、プロジェクトのプロパティ→ビルド　や、プロジェクトファイルの<ProjectGroup>の<DefineConstants>で定義することもできる。

#define AAAA

#if DEBUG
Console.WriteLine("DEBUG");
#endif

#if RELEASE
Console.WriteLine("RELEASE");
#endif

#if TRACE
Console.WriteLine("TRACE");
#endif

#if AAAA
Console.WriteLine("AAAA");
#endif

#define AAAA

#if DEBUG

Console.WriteLine("DEBUG");

#endif

#if RELEASE

Console.WriteLine("RELEASE");

#endif

#if TRACE

Console.WriteLine("TRACE");

#endif

#if AAAA

Console.WriteLine("AAAA");

#endif

プロジェクトのプロパティ

デバッグのときのみ実行されるメソッドを定義する

以下のABC()はデバッグ時のみ実行される。

ABC();

//条件付きメソッド デバッグのときだけ実行されるメソッド
[System.Diagnostics.Conditional("DEBUG")]
static void ABC()
{
    Console.WriteLine("ABC");
}

ABC();

//条件付きメソッドデバッグのときだけ実行されるメソッド

[System.Diagnostics.Conditional("DEBUG")]

static void ABC()

{

Console.WriteLine("ABC");

}

意図的にコンパイルエラー/警告を出力する

意図的にエラーや警告を出力するには#errorや#worningを使う。
#lineを使うと、指定した場所（行番号・ファイル名）でエラーが発生したように見せかけることができる。ファイル名は実際に存在するファイルでなくてもよい。
以下の5行目の例では、#lineから下のエラーの発生場所はtest.csファイルの100行目〜となる。

#error エラーです

#warning このソースファイルは未完成です

#line 100 "test.cs"
var number;   //初期化子がないためエラー

#line 200　//ファイルは無しで行番号だけ指定
var number2;

#line default　//通常の表示に戻る
var number3;

#error エラーです

#warning このソースファイルは未完成です

#line 100 "test.cs"

var number; //初期化子がないためエラー

#line 200　//ファイルは無しで行番号だけ指定

var number2;

#line default　//通常の表示に戻る

var number3;

エディターでグループを折りたたむ

#region～#endregionまでをエディタで折りたたむことができる。（対応エディタのみ）
ラベルを付けたい場合は「#region ラベル」と書く。折りたたんだ時にはラベルのみが表示される。

#region Greetings

Console.WriteLine("おはよう");
Console.WriteLine("こんにちは");
Console.WriteLine("こんばんは");

#endregion

#region Greetings

Console.WriteLine("おはよう");

Console.WriteLine("こんにちは");

Console.WriteLine("こんばんは");

#endregion

警告を無効にする

//警告を無効にする
#pragma warning disable

//指定されたコードの警告を無効にする
#pragma warning disable CS0168
int a;

//null許容参照機能からの警告を無効にする
#pragma warning disable nullable