novo modificador (translation from VPE for Csharp Reference)

Quando usado sistema autônomo um modificador, a new palavra-chave explicitamente oculta um membro herdado de uma classe base. Quando você ocultar um membro herdado, a versão derivada do membro substitui a versão de classe base.Embora você pode ocultar membros sem o uso do new modificador, o resultado é um aviso. Se você usar new Para ocultar explicitamente um membro, ele suprime o aviso e documenta o fato de que a versão derivada serve sistema autônomo uma substituição.

Para ocultar um membro herdado, declará-lo na classe derivada usando o mesmo nome e modificá-la 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 é oculto por DerivedC.Invoke. O campo x não é afetado porque ele não está oculto por um nome semelhante.

Ocultando através de herança de nome tem um dos seguintes formatos:

  • Uma constante, campo, propriedade ou tipo introduzido em class ou struct oculta todos os membros da classe base com o mesmo nome.

  • Um método introduzido em class ou struct oculta propriedades, campos e tipos, com o mesmo nome, na classe base.Ele também oculta todos os métodos da classe base com a mesma assinatura.

  • Um indexador introduzido em class ou struct oculta todos os indexadores de classe base com a mesma assinatura.

É um erro usar ambos os new e Substituir no mesmo membro porque dois modificadores têm significados mutuamente exclusivo.The new modificador cria um novo membro com o mesmo nome e faz com que o membro original ficam ocultas. The override modificador amplia a implementação de um membro herdado.

Usando o new modificador em uma declaração não oculta um membro herdado gera um aviso.

Exemplo

Este exemplo, uma classe base, BaseCe uma classe derivada, DerivedC, use o mesmo nome de campo x, que oculta o valor de campo herdado. O exemplo demonstra o uso do new modificador. Ele também demonstra como acessar os oculto membros 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 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 oculto 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 será ainda compilado e executado, mas você receberá a seguinte advertência:

The keyword new is required on 'MyDerivedC.x' because it hides inherited member 'MyBaseC.x'.

Você também pode usar o new modificador para modificar um tipo aninhado se o tipo aninhado é ocultar outro tipo, conforme demonstrado no exemplo a seguir.

Especificação da linguagem C#

Para obter mais informações, consulte a seção a seguir no Especificação da linguagem C#:

  • 10.3.4 O modificador de novo

Consulte também

Conceitos

Guia de Programação C#

Referência

Palavras-chave C#

Operador de palavras-chave (translation from VPE for Csharp Reference)

Modificadores (referência C#)

Outros recursos

Referência C#