new 修飾符（C# 參考） · MSDN C# 編程指南 & 參考手冊 2015

# new 修飾符（C# 參考）在用作聲明修飾符時，**new** 關鍵字可以顯式隱藏從基類繼承的成員。隱藏繼承的成員時，該成員的派生版本將替換基類版本。雖然可以不使用 **new** 修飾符來隱藏成員，但將收到編譯器警告。如果使用 **new** 來顯式隱藏成員，將禁止此警告。若要隱藏繼承的成員，請使用相同名稱在派生類中聲明該成員，并使用 **new** 修飾符對其進行修飾。例如: ``` public class BaseC { public int x; public void Invoke() { } } public class DerivedC : BaseC { new public void Invoke() { } } ``` 在此示例中，使用 BaseC.Invoke 隱藏了 DerivedC.Invoke。字段 x 不受影響，因為未使用類似名稱將其隱藏。通過繼承隱藏名稱采用下列形式之一： * 通常，在類或結構中引入的常數、字段、屬性或類型會隱藏與其共享名稱的所有基類成員。有三種特殊情況。例如，如果將名稱為 N 的新字段聲明為不可調用的類型，并且基類型將 N 聲明為一種方法，則新字段在調用語法中不會隱藏基聲明。請參閱 [C# 語言規范](http://go.microsoft.com/fwlink/?LinkId=199552)獲取詳細信息（請參閱“表達式”一節中“成員查找”部分）。 * 類或結構中引入的方法會隱藏基類中共享該名稱的屬性、字段和類型。它還會隱藏具有相同簽名的所有基類方法。 * 類或結構中引入的索引器會隱藏具有相同簽名的所有基類索引器。對同一成員同時使用 **new** 和 [override](https://msdn.microsoft.com/zh-cn/library/ebca9ah3.aspx) 是錯誤的做法，因為這兩個修飾符的含義互斥。 **new** 修飾符會用同樣的名稱創建一個新成員并使原始成員變為隱藏。 **override** 修飾符會擴展繼承成員的實現。在不隱藏繼承成員的聲明中使用 **new** 修飾符將會生成警告。在此示例中，基類 BaseC 和派生類 DerivedC 使用相同的字段名 x，從而隱藏了繼承字段的值。此示例演示 **new** 修飾符的用法。另外還演示了如何使用完全限定名訪問基類的隱藏成員。 ``` public class BaseC { public static int x = 55; public static int y = 22; } public class DerivedC : BaseC { // Hide field 'x'. new public static int x = 100; static void Main() { // Display the new value of x: Console.WriteLine(x); // Display the hidden value of x: Console.WriteLine(BaseC.x); // Display the unhidden member y: Console.WriteLine(y); } } /* Output: 100 55 22 */ ``` 在此示例中，嵌套類隱藏了基類中同名的類。此示例演示如何使用 **new** 修飾符來消除警告消息，以及如何使用完全限定名來訪問隱藏的類成員。 ``` public class BaseC { public class NestedC { public int x = 200; public int y; } } public class DerivedC : BaseC { // Nested type hiding the base type members. new public class NestedC { public int x = 100; public int y; public int z; } static void Main() { // Creating an object from the overlapping class: NestedC c1 = new NestedC(); // Creating an object from the hidden class: BaseC.NestedC c2 = new BaseC.NestedC(); Console.WriteLine(c1.x); Console.WriteLine(c2.x); } } /* Output: 100 200 */ ``` 如果移除 **new** 修飾符，程序仍將編譯和運行，但你會收到以下警告： ``` The keyword new is required on 'MyDerivedC.x' because it hides inherited member 'MyBaseC.x'. ``` ## C# 語言規范有關詳細信息，請參閱 [C# 語言規范](https://msdn.microsoft.com/zh-cn/library/ms228593.aspx)。該語言規范是 C# 語法和用法的權威資料。 ## 請參閱 [C# 參考](https://msdn.microsoft.com/zh-cn/library/618ayhy6.aspx) [C# 編程指南](https://msdn.microsoft.com/zh-cn/library/67ef8sbd.aspx) [C# 關鍵字](https://msdn.microsoft.com/zh-cn/library/x53a06bb.aspx) [運算符關鍵字（C# 參考）](https://msdn.microsoft.com/zh-cn/library/bewds7kc.aspx) [修飾符（C# 參考）](https://msdn.microsoft.com/zh-cn/library/6tcf2h8w.aspx) [使用 Override 和 New 關鍵字進行版本控制（C# 編程指南）](https://msdn.microsoft.com/zh-cn/library/6fawty39.aspx) [了解何時使用 Override 和 New 關鍵字（C# 編程指南）](https://msdn.microsoft.com/zh-cn/library/ms173153.aspx)