new 修饰符(C# 参考)
在用作声明修饰符时,new
关键字可以显式隐藏从基类继承的成员。 隐藏继承的成员时,该成员的派生版本将替换基类版本。 这假定该成员的基类版本是可见的,因为如果它被标记为 private
,或在某些情况下被标记为 internal
,则基类版本已隐藏。 虽然不使用 new
修饰符即可隐藏 public
和 protected
成员,但将收到编译器警告。 如果使用 new
来显式隐藏成员,将禁止此警告。
若要隐藏继承的成员,请使用相同名称在派生类中声明该成员,并使用 new
修饰符对其进行修饰。 例如:
public class BaseC
{
public int x;
public void Invoke() { }
}
public class DerivedC : BaseC
{
new public void Invoke() { }
}
在此示例中,使用 DerivedC.Invoke
隐藏了 BaseC.Invoke
。 字段 x
不受影响,因为未使用类似名称将其隐藏。
通过继承隐藏名称采用下列形式之一:
通常,在类或结构中引入的常数、字段、属性或类型会隐藏与其共享名称的所有基类成员。 有三种特殊情况。 例如,如果将名称为
N
的新字段声明为不可调用的类型,并且基类型将N
声明为一种方法,则新字段在调用语法中不会隐藏基声明。 有关详细信息,请参阅 C# 语言规范中的成员查找部分。类或结构中引入的方法会隐藏基类中共享该名称的属性、字段和类型。 它还会隐藏具有相同签名的所有基类方法。
类或结构中引入的索引器会隐藏具有相同签名的所有基类索引器。
对同一成员同时使用 new
和 override 是错误的做法,因为这两个修饰符的含义互斥。 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# 语言规范中的 new 修饰符部分。