novo Modificador (referência de C#)
Quando usado como um modificador de new palavra-chave explicitamente oculta um membro herdado de uma classe de base. Quando você oculta um membro herdado, a versão derivada do membro substitui a versão da classe base. Embora você pode ocultar membros sem usar o new o modificador, o resultado é um aviso. Se você usar new explicitamente ocultar um membro, ele suprime esse aviso e documentos o fato de que a versão derivada destina-se como um substituto.
Para ocultar um membro herdado, declará-lo na classe derivada, usando o mesmo nome e modificá-lo com o new modificador. Por exemplo:
public class BaseC
{
public int x;
public void Invoke() { }
}
public class DerivedC : BaseC
{
new public void Invoke() { }
}
Neste exemplo, BaseC.Invoke estão ocultos por DerivedC.Invoke. O campo x não é afetado porque ele não está oculto por um nome semelhante.
Nome ocultando através de herança leva a uma das seguintes formas:
Uma constante, campo, propriedade ou tipo introduzido em uma classe ou struct oculta todos os membros da classe base com o mesmo nome.
Um método introduzido em uma classe ou struct oculta as propriedades, campos e tipos, com o mesmo nome, na classe base. Ele também oculta todos os métodos de classe base com a mesma assinatura.
Um indexador introduzido em uma classe ou struct oculta todos os indexadores de classe base com a mesma assinatura.
É um erro usar ambos new e Substituir no mesmo membro porque os dois modificadores tem significados mutuamente exclusivos. O new modificador cria um novo membro com o mesmo nome e faz com que o membro original como ficam ocultas. O override modificador estende a implementação de um membro herdado.
Usando o new modificador em uma declaração que não oculta um membro herdado gera um aviso.
Exemplo
Neste exemplo, uma classe base, BaseCe uma classe derivada, DerivedC, use o mesmo nome do campo x, que oculta o valor do campo herdadas. O exemplo demonstra o uso de new modificador. Ele também demonstra como acessar os membros ocultos da classe base, usando seus nomes totalmente qualificados.
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
*/
Neste exemplo, uma classe aninhada oculta de uma classe que tem o mesmo nome na classe base. O exemplo demonstra como usar o new modificador para eliminar a mensagem de aviso e como acessar os membros de classe ocultos usando seus nomes totalmente qualificados.
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
*/
Se você remover o new modificador, o programa ainda será compilado e executado, mas você receberá o seguinte aviso:
The keyword new is required on 'MyDerivedC.x' because it hides inherited member 'MyBaseC.x'.
Especificação da linguagem C#
Para obter mais informações, consulte C# Language Specification A especificação de linguagem é a fonte definitiva para a sintaxe e o uso de C#.
Consulte também
Referência
Palavras-chave de operador (referência de C#)