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)