C#名前空間完全ガイド：構成、スコープ、ベストプラクティス

C#名前空間をマスターする：構成、スコープ、ベストプラクティス

名前空間がC#コードをいかにクリーンに保ち、命名競合を防ぎ、スケーラブルなプロジェクトを可能にするかを解説します。

名前空間はC#コード構成の要です。関連するクラス、インターフェイス、構造体、デリゲートをグループ化する「フォルダ」のようなものと捉えると分かりやすく、大規模コードベースを管理しやすくし、命名衝突を減らします。

名前空間に含められる典型的なメンバー：

1. ネストされた名前空間
2. クラス
3. インターフェイス
4. 構造体
5. デリゲート

名前空間は任意ですが、明確性と保守性の観点から使用するのがベストプラクティスです。

デスクトップ上のファイルが単一フォルダに散らばっている状態を想像してください——探すのが大変です。名前空間は、このディレクトリ構造をコード上で再現し、関連する型をまとめます。

また命名衝突も解決します：Logger という同名クラスでも、別々の名前空間にあれば共存できます。

---

名前空間の定義

namespace キーワードで宣言します：

namespace MyNamespace {
    // 名前空間の内容
}

実例：

namespace MyNamespace {
    class MyClass {
        public void MyMethod() {
            System.Console.WriteLine("Creating my namespace");
        }
    }
}

これは MyNamespace を定義し、その中に MyClass を含め、そのメソッドがメッセージを出力します。

---

名前空間メンバーへのアクセス

ドット演算子でメンバーを参照します：

NamespaceName.MemberName

インスタンス生成の例：

MyNamespace.MyClass myClass = new MyNamespace.MyClass();

以下のプログラムでは、MyProgram から MyNamespace のクラスを呼び出しています：

using System;

namespace MyNamespace {
    public class SampleClass {
        public static void MyMethod() {
            Console.WriteLine("Creating my namespace");
        }
    }
}

namespace MyProgram {
    public class MyClass {
        public static void Main() {
            MyNamespace.SampleClass.MyMethod();
        }
    }
}

実行結果：

Creating my namespace

---

using キーワードの活用

毎回完全修飾名を書く代わりに、ファイル冒頭で名前空間をインポートします：

using System;

これで以下のように書けます：

Console.WriteLine("Hello World!");

System.Console.WriteLine の代わりになります。

---

ネストされた名前空間

名前空間は他の名前空間を含められ、階層構造を作れます：

namespace MyNamespace {
    namespace Nested {
        // 内容
    }
}

ネストされたメンバーへのアクセスもドット演算子で：

MyNamespace.Nested.ClassName

実例：

using System;

namespace MyNamespace {
    namespace Nested {
        public class SampleClass {
            public static void MyMethod() {
                Console.WriteLine("Nested Namespace Example");
            }
        }
    }
}

namespace MyProgram {
    public class MyClass {
        public static void Main() {
            MyNamespace.Nested.SampleClass.MyMethod();
        }
    }
}

出力：

Nested Namespace Example

ネストされた名前空間は、大規模ソリューションを論理的なセクションに構造化し、コード上でファイルシステムのようなレイアウトを実現するのに役立ちます。