using System;
using System.Diagnostics;

class Sample {
  // コンパイラ定数"DEBUG"が定義されている場合のみ有効になるメソッド
  // ref引数で値の入力と結果の出力を行う
  [Conditional("DEBUG")]
  static void Increment(ref int x)
  {
    x += 1;
  }

  static void Main()
  {
    int x = 0;

    // 引数で与えられる変数の値をインクリメントし、結果を同じ変数に格納する
    Increment(ref x);

    Console.WriteLine($"x = {x}");
  }
}

Imports System
Imports System.Diagnostics

Class Sample
  ' コンパイラ定数"DEBUG"が定義されている場合のみ有効になるメソッド
  ' ByRef引数で値の入力と結果の出力を行う
  <Conditional("DEBUG")> _
  Shared Sub Increment(ByRef x As Integer)
    x += 1
  End Sub

  Shared Sub Main()
    Dim x As Integer = 0

    ' 引数で与えられる変数の値をインクリメントし、結果を同じ変数に格納する
    Increment(x)

    Console.WriteLine($"x = {x}")
  End Sub
End Class

using System;
using System.Diagnostics;

class Sample {
  // コンパイラ定数"DEBUG"または"TEST"が定義されている場合のみ有効になるメソッド
  [Conditional("DEBUG")]
  [Conditional("TEST")]
  static void PrintMessage(string message)
    => Console.WriteLine(message);

  static void Main()
  {
    // DEBUGまたはTESTが定義されていれば、呼び出しが行われる
    PrintMessage("Hello, world!");

    // #ifディレクティブで相当するコードを書くとすれば次のようになる
#if DEBUG || TEST
    //PrintMessage("Hello, world!");
#endif
  }
}

Imports System
Imports System.Diagnostics

Class Sample
  ' コンパイラ定数"DEBUG"または"TEST"が定義されている場合のみ有効になるメソッド
  <Conditional("DEBUG")> _
  <Conditional("TEST")> _
  Shared Sub PrintMessage(ByVal message As String)
    Console.WriteLine(message)
  End Sub

  Shared Sub Main()
    ' DEBUGまたはTESTが定義されていれば、呼び出しが行われる
    PrintMessage("Hello, world!")

    ' #Ifディレクティブで相当するコードを書くとすれば次のようになる
#If DEBUG Or TEST Then
    'PrintMessage("Hello, world!")
#End If
  End Sub
End Class

class X {
  public static void CallAvailableIfNotDebug() => C.AvailableIfNotDebug();
  public static void CallAvailableIfDebug() => C.AvailableIfDebug();
}

#if !DEBUG
// DEBUGが*定義されていない*場合、NOT_DEBUGを定義する
#define NOT_DEBUG
#endif

using System;
using System.Diagnostics;
using System.Runtime.CompilerServices;

static class C {
  // DEBUGが定義されていない(NOT_DEBUGが定義されている)場合のみ有効になるメソッド
  [Conditional("NOT_DEBUG")]
  public static void AvailableIfNotDebug(
    [CallerFilePath] string sourceFilePath = null // 呼び出し元のファイル名を取得する
  )
    => Console.WriteLine($"NOT_DEBUG: {sourceFilePath}");

  // (比較のため)DEBUGが定義されている場合のみ有効となるメソッド
  [Conditional("DEBUG")]
  public static void AvailableIfDebug(
    [CallerFilePath] string sourceFilePath = null // 呼び出し元のファイル名を取得する
  )
    => Console.WriteLine($"DEBUG: {sourceFilePath}");
}

class Sample {
  static void Main()
  {
    // 同一ファイル内から直接呼び出す
    C.AvailableIfNotDebug();
    // 異なるファイルのメソッドを経由して呼び出す
    X.CallAvailableIfNotDebug();

    // 同一ファイル内から直接呼び出す
    C.AvailableIfDebug();
    // 異なるファイルのメソッドを経由して呼び出す
    X.CallAvailableIfDebug();
  }
}

Class X
  Public Shared Sub CallAvailableIfNotDebug()
    M.AvailableIfNotDebug()
  End Sub

  Public Shared Sub CallAvailableIfDebug()
    M.AvailableIfDebug()
  End Sub
End Class

#If DEBUG <> True Then
' DEBUGが*定義されていない*場合、NOT_DEBUGを定義する
#Const NOT_DEBUG = True
#End If

Imports System
Imports System.Diagnostics
Imports System.Runtime.CompilerServices

Module M
  ' DEBUGが定義されていない(NOT_DEBUGが定義されている)場合のみ有効になるメソッド
  <Conditional("NOT_DEBUG")>
  Public Sub AvailableIfNotDebug(
    <CallerFilePath> Optional ByVal sourceFilePath As String = Nothing ' 呼び出し元のファイル名を取得する
  )
    Console.WriteLine($"NOT_DEBUG: {sourceFilePath}")
  End Sub

  ' (比較のため)DEBUGが定義されている場合のみ有効となるメソッド
  <Conditional("DEBUG")>
  Public Sub AvailableIfDebug(
    <CallerFilePath> Optional ByVal sourceFilePath As String = Nothing ' 呼び出し元のファイル名を取得する
  )
    Console.WriteLine($"DEBUG: {sourceFilePath}")
  End Sub
End Module

Class Sample
  Shared Sub Main()
    ' 同一ファイル内から直接呼び出す
    M.AvailableIfNotDebug()
    ' 異なるファイルのメソッドを経由して呼び出す
    X.CallAvailableIfNotDebug()

    ' 同一ファイル内から直接呼び出す
    M.AvailableIfDebug()
    ' 異なるファイルのメソッドを経由して呼び出す
    X.CallAvailableIfDebug()
  End Sub
End Class

using System;
using System.Diagnostics;

class C0 {
  [Conditional("D0")]
  public virtual void M() => Console.WriteLine("C0");
}

class C1 : C0 {
  // Conditionalなメソッドをオーバーライドしたメソッドでは
  // Conditional属性を追加で付与することはできない
  /*
  [Conditional("D1")] // error CS0243: 条件付き属性はオーバーライド メソッドであるため、 'C1.M()' では無効です
  */
  public override void M() => Console.WriteLine("C1");
}

class Sample {
  static void Main()
  {
    var c0 = new C0();
    var c1 = new C1();

    c0.M(); // D0が定義されている場合は呼び出される
    c1.M(); // D0が定義されている場合は呼び出される(基底クラスのメソッドと同様)
  }
}

Imports System
Imports System.Diagnostics

Class C0
  <Conditional("D0")> _
  Public Overridable Sub M()
    Console.WriteLine("C0")
  End Sub
End Class

Class C1
  Inherits C0
  ' Conditionalなメソッドをオーバーライドしたメソッドでも
  ' Conditional属性を付与することができる
  ' (基底クラスでのConditional属性の指定が上書きされる)
  <Conditional("D1")> _
  Public Overrides Sub M()
    Console.WriteLine("C1")
  End Sub
End Class

Class Sample
  Shared Sub Main()
    Dim c0 As New C0()
    Dim c1 As New C1()

    c0.M() ' D0が定義されている場合に呼び出される
    c1.M() ' D1が定義されている場合に呼び出される (D0の定義には影響されない)
  End Sub
End Class

using System;
using System.Diagnostics;

class Sample {
  // コンパイラ定数"DEBUG"が定義されている場合のみ有効になるメソッド
  [Conditional("DEBUG")]
  static void Log(string message)
    => Console.WriteLine(message);

  static void Main()
  {
    // Conditionalなメソッドをnameof演算子で参照することはできる
    Console.WriteLine(nameof(Log));

    // Conditionalなメソッドからデリゲートを作成することはできない
    Action<string> log = Log; // error CS1618: 'Sample.Log(string)' またはオーバーライドされるメソッドは条件付き属性なので、この属性でデリゲートを作成できません

    log("Hello, world!");
  }
}

Imports System
Imports System.Diagnostics

Class Sample
  ' コンパイラ定数"DEBUG"が定義されている場合のみ有効になるメソッド
  <Conditional("DEBUG")> _
  Shared Sub Log(ByVal message As String)
    Console.WriteLine(message)
  End Sub
  
  Shared Sub Main()
    ' ConditionalなメソッドをNameOf演算子で参照することはできる
    Console.WriteLine(NameOf(Log))

    ' Conditionalなメソッドからデリゲートを作成することができる
    Dim l As Action(Of String) = AddressOf Log ' コンパイルエラーとはならない

    ' Conditionalなメソッドを参照するデリゲートを呼び出すこともできる
    ' Conditional属性は無視されるため、コンパイラ定数に関わらず呼び出せることになる
    l("Hello, world!")
  End Sub
End Class

Log
Hello, world!

using System;
using System.Diagnostics;
using System.Reflection;

class Sample {
  // コンパイラ定数"DEBUG"が定義されている場合のみ有効になるメソッド
  [Conditional("DEBUG")]
  public static void Log(string message)
    => Console.WriteLine(message);

  static void Main()
  {
#if DEBUG
    // コンパイラ定数DEBUGが定義されている場合は表示する
    Console.WriteLine("DEBUG");
#endif

    // リフレクションによって上記のConditionalなメソッドを呼び出す
    // (コンパイルエラー等にはならず、またコンパイラ定数の定義に関わらず呼び出せてしまう)
    typeof(Sample).InvokeMember(nameof(Log), BindingFlags.InvokeMethod, null, null, new object[] {"Hello, world!"});
  }
}

Imports System
Imports System.Diagnostics
Imports System.Reflection

Class Sample
  ' コンパイラ定数"DEBUG"が定義されている場合のみ有効になるメソッド
  <Conditional("DEBUG")> _
  Shared Sub Log(ByVal message As String)
    Console.WriteLine(message)
  End Sub
  
  Shared Sub Main()
#If DEBUG Then
    ' コンパイラ定数DEBUGが定義されている場合は表示する
    Console.WriteLine("DEBUG")
#End If

    ' リフレクションによって上記のConditionalなメソッドを呼び出す
    ' (コンパイルエラー等にはならず、またコンパイラ定数の定義に関わらず呼び出せてしまう)
    GetType(Sample).InvokeMember(NameOf(Log), BindingFlags.InvokeMethod, Nothing, Nothing, New Object() {"Hello, world!"})
  End Sub
End Class

// #defineでファイル内のみの局所的なコンパイラ定数を定義できる
#define TEST

// #defineをマクロのように使用することはできない
#define MAX_USER_COUNT 10 // error CS1025: 単一行コメントか行末が必要です

using System;

class Sample {
  // 物理定数など実行環境などによらず不変な定数・外部に公開されず将来的な変更の余地がない値はconstが向いている
  const double Pi = 3.14;

  // 外部に公開され、かつ将来的に変更される可能性のある値や、外部から読み込まれる設定値(コンパイル時に決定できない値)はreadonlyを用いる
  // クラス外からも参照されるような大域的な不変値など、一般にはstatic readonlyとすることが多い
  public static readonly int MaxUserCount = 10;

  // 定義済みの値を持ったインスタンス・シングルトンインスタンスなどはreadonlyを用いる
  // (クラスインスタンス変数はconstにできない)
  static readonly User SuperUser = new User("root", 0);

  public class User {
    // コンストラクタ引数として与えられ、以降変更されない(参照のみとなる)ような値は、readonlyを用いる
    private readonly string name;
    private readonly int id;

    // 外部に公開されない・局所的に用いられる特殊値の定義などは、constが向いている
    private const int invalid_id = -1;

    public User(string name, int id)
    {
      if (id == invalid_id || id == SuperUser.id)
        throw new ArgumentException(nameof(id));

      // 変数初期化またはコンストラクタでの初期化以外で、readonly変数の値を変更することはできない
      this.name = name;
      this.id = id;

      // コンパイラ定数は#ifなどのディレクティブでのみ使用できる(値を展開することはできない)
#if TEST
      Console.WriteLine($"{name}:{id}");
#endif
    }

    public void Deactivate()
    {
      // readonlyな変数には再代入できない
      name = "(deactivated user)"; // error CS0191: 読み取り専用フィールドに割り当てることはできません (フィールドが定義されている型のコンストラクターか init 専用セッター、または変数初期化子では可)
      id = invalid_id; // error CS0191: 読み取り専用フィールドに割り当てることはできません (フィールドが定義されている型のコンストラクターか init 専用セッター、または変数初期化子では可)
    }
  }
}

' #Constでファイル内のみの局所的なコンパイラ定数を定義できる
#Const TEST = 1

' #Constでコンパイラ定数に値を与えることはできるが、マクロのようにコード内に値を展開することはできない
#Const MAX_USER_COUNT = 10

Imports System
Imports System.Diagnostics

Class Sample
  ' 物理定数など実行環境などによらず不変な定数・外部に公開されず将来的な変更の余地がない値はConstが向いている
  Const Pi As Double = 3.14

  ' 外部に公開され、かつ将来的に変更される可能性のある値や、外部から読み込まれる設定値(コンパイル時に決定できない値)はReadOnlyを用いる
  ' クラス外からも参照されるような大域的な不変値など、一般にはShared ReadOnlyとすることが多い
  Public Shared ReadOnly MaxUserCount As Integer = 10

  ' 定義済みの値を持ったインスタンス・シングルトンインスタンスなどはReadOnlyを用いる
  ' (クラスインスタンス変数はConstにできない)
  Shared ReadOnly SuperUser As New User("root", 0)

  Public Class User
    ' コンストラクタ引数として与えられ、以降変更されない(参照のみとなる)ような値は、ReadOnlyを用いる
    Private ReadOnly _name As String
    Private ReadOnly _id As Integer

    ' 外部に公開されない・局所的に用いられる特殊値の定義などは、Constが向いている
    Private Const invalid_id As Integer = -1

    Public Sub New(ByVal name As String, ByVal id As Integer)
      If id = invalid_id OrElse id = SuperUser._id Then
        Throw New ArgumentException(NameOf(id))
      End If

      ' 変数初期化またはコンストラクタでの初期化以外で、ReadOnly変数の値を変更することはできない
      _name = name
      _id = id

      ' コンパイラ定数は#Ifなどのディレクティブでのみ使用できる(値を展開することはできない)
#If TEST = 1 Then
      Console.WriteLine($"{_name}:{_id}")
#End If
    End Sub

    Public Sub Deactivate()
      ' ReadoOlyな変数には再代入できない
      _name = "(deactivated user)" ' error BC30064: 'ReadOnly' 変数を代入式のターゲットにすることはできません。
      _id = invalid_id ' error BC30064: 'ReadOnly' 変数を代入式のターゲットにすることはできません。
    End Sub
  End Class

  Shared Sub Main()
  End Sub
End Class

    ︙
  <PropertyGroup>
    <!-- 3つのコンパイラ定数FOO, BAR, BAZを定義する -->
    <DefineConstants>FOO;BAR;BAZ</DefineConstants>

    <!-- ビルド構成(Configuration)がDebugの場合に、DefineConstantsにDEBUG_FOOとDEBUG_BARを追加する -->
    <DefineConstants Condition=" '$(Configuration)' == 'Debug' ">$(DefineConstants);DEBUG_FOO;DEBUG_BAR</DefineConstants>
  </PropertyGroup>
    ︙

    ︙
  <PropertyGroup>
    <!-- 3つのコンパイラ定数FOO, BAR, BAZを定義する -->
    <DefineConstants>FOO,BAR,BAZ</DefineConstants>

    <!-- ビルド構成(Configuration)がDebugの場合に、DefineConstantsにDEBUG_FOOとDEBUG_BARを追加する -->
    <DefineConstants Condition=" '$(Configuration)' == 'Debug' ">$(DefineConstants),DEBUG_FOO,DEBUG_BAR</DefineConstants>
  </PropertyGroup>
    ︙

#define FOO // このファイル内でのみ有効なコンパイラ定数FOOを定義する
#undef DEBUG // コンパイラ定数DEBUGを未定義化する

using System;

class Sample {
  static void Main()
  {
#if FOO // このファイル内では常にFOOが定義されるので、このコードは常に有効になる
    Console.WriteLine("FOO");
#endif

#if DEBUG // このファイル内では常にDEBUGが未定義化されるので、このコードは常に無効になる
    Console.WriteLine("DEBUG");
#endif

// ファイルの先頭以外で#define/#undefを記述することはできない
#define BAR // error CS1032: ファイルの最初のトークンの後でプリプロセッサのシンボルの定義または定義の解除を行えませんでした
  }
}

#Const FOO = True ' このファイル内でのみ有効なコンパイラ定数FOOを定義する
#Const DEBUG = Nothing ' コンパイラ定数DEBUGを未定義化する

Imports System

Class Sample
  Shared Sub Main()
#If FOO Then ' このファイル内では常にFOOが定義されるので、このコードは常に有効になる
    Console.WriteLine("FOO")
#End If

#If DEBUG Then ' このファイル内では常にDEBUGが未定義化されるので、このコードは常に無効になる
    Console.WriteLine("DEBUG")
#End If

' ファイルの先頭以外でも#Constを記述することができる
#Const FOO = Nothing

#If FOO Then ' 直上でFOOが未定義化されているので、このコードは常に無効になる
    Console.WriteLine("FOO-2")
#End If
  End Sub
End Class