命名空間

發行項
11/07/2024

namespace 關鍵字用來宣告包含一組相關物件的範圍。您可以使用命名空間來組織程式碼項目，並建立全域唯一的型別。

namespace SampleNamespace
{
    class SampleClass { }

    interface ISampleInterface { }

    struct SampleStruct { }

    enum SampleEnum { a, b }

    delegate void SampleDelegate(int i);

    namespace Nested
    {
        class SampleClass2 { }
    }
}

「檔案範圍的命名空間宣告」可讓您宣告檔案中的所有類型都會位於單一命名空間中。檔案範圍的命名空間宣告適用於 C# 10。下列範例與上一個範例類似，但使用檔案範圍的命名空間宣告：

using System;

namespace SampleFileScopedNamespace;

class SampleClass { }

interface ISampleInterface { }

struct SampleStruct { }

enum SampleEnum { a, b }

delegate void SampleDelegate(int i);

在檔案範圍命名空間中使用語句

使用 檔案範圍的命名空間時，語句的位置 using 會影響其在檔案中的範圍。檔案範圍的命名空間會低於相等的傳統命名空間宣告，其結尾為檔案結尾的右括號。此行為會決定套用指示詞的位置 using ，如下所示：

using如果語句放在檔案範圍命名空間宣告之前，則會將其視為不在命名空間之外，並解譯為完整命名空間。
using如果語句放在檔案範圍命名空間宣告之後，這些語句的範圍會限定在命名空間本身內。

例如：

// This using is outside the namespace scope, so it applies globally
using System;

namespace SampleNamespace; // File-scoped namespace declaration

// This using is inside the namespace scope
using System.Text;

public class SampleClass
{
    // Class members...
}

在上述範例中，System全域可存取，但System.Text僅適用於。SampleNamespace

上述範例未包含巢狀命名空間。檔案範圍的命名空間不能包含其他命名空間宣告。您無法宣告巢狀命名空間或第二個檔案範圍的命名空間：

namespace SampleNamespace;

class AnotherSampleClass
{
    public void AnotherSampleMethod()
    {
        System.Console.WriteLine(
            "SampleMethod inside SampleNamespace");
    }
}

namespace AnotherNamespace; // Not allowed!

namespace ANestedNamespace // Not allowed!
{
   // declarations...
}

在命名空間內，您可以宣告下列一或多個類型：

class
interface
struct
enum
delegate
可以宣告巢狀命名空間，但不能在檔案範圍的命名空間宣告中

編譯器會新增預設命名空間。這個未命名的命名空間，有時候是指全域命名空間，會出現在每個檔案中。它包含未包含在宣告命名空間中的宣告。全域命名空間中的任何識別項都可用於具名命名空間中。

命名空間會隱含地具有公用存取權。如需可在命名空間中指派給項目之存取修飾詞的討論，請參閱存取修飾詞。

您可在兩個或多個宣告中定義命名空間。例如，下例會將兩個類別定義為 MyCompany 命名空間的一部分︰

namespace MyCompany.Proj1
{
    class MyClass
    {
    }
}

namespace MyCompany.Proj1
{
    class MyClass1
    {
    }
}

下例顯示如何在巢狀命名空間中呼叫靜態方法。

namespace SomeNameSpace
{
    public class MyClass
    {
        static void Main()
        {
            Nested.NestedNameSpaceClass.SayHello();
        }
    }

    // a nested namespace
    namespace Nested
    {
        public class NestedNameSpaceClass
        {
            public static void SayHello()
            {
                Console.WriteLine("Hello");
            }
        }
    }
}
// Output: Hello

C# 語言規格

如需詳細資訊，請參閱 C# 語言規格的命名空間一節。如需檔案範圍的命名空間宣告詳細資訊，請參閱功能規格。

共用方式為

命名空間

在檔案範圍命名空間中使用語句

C# 語言規格

另請參閱

其他資源