Udostępnij za pośrednictwem


new — Modyfikator (odwołanie w C#)

W przypadku stosowania jako modyfikator deklaracji, słowo kluczowe new jawnie ukrywa element członkowski, który jest dziedziczony z klasy bazowej.Po ukryciu dziedziczonego członka, pochodna wersja członka zastępuje wersję klasy podstawowej.Chociaż można ukryć elementy członkowskie bez korzystania z modyfikatora new, zostanie wyświetlone ostrzeżenie kompilatora.Jeśli używasz new, aby jawnie ukryć członka, powoduje to pominięcie ostrzeżenia.

Aby ukryć dziedziczony element członkowski, zadeklaruj go w klasie pochodnej przy użyciu tej samej nazwy elementu członkowskiego i zmodyfikuj go za pomocą słowa kluczowego new.Na przykład:

public class BaseC
{
    public int x;
    public void Invoke() { }
}
public class DerivedC : BaseC
{
    new public void Invoke() { }
}

W tym przykładzie BaseC.Invoke jest ukryta przez DerivedC.Invoke.Pole x pozostanie niezmienione, ponieważ nie jest ono ukryte przez podobną nazwę.

Ukrywanie nazw poprzez dziedziczenie ma jedną z następujących form:

  • Ogólnie rzecz biorąc, stała, pole, właściwość lub typ, który został wprowadzony w klasie lub strukturze, powoduje ukrycie wszystkich członków klasy podstawowej, które współdzielą jego nazwę. Istnieją przypadki specjalne. Na przykład, jeśli zadeklarujesz nowe pole o nazwie N, aby uzyskać typ, którego nie można wywołać, a typ podstawowy deklaruje N jako metodę, nowe pole nie powoduje ukrycia podstawowej deklaracji w składni wywołania. Zobacz Specyfikacja języka C#, aby dowiedzieć się więcej (zobacz sekcję "Wyszukanie członka" w sekcji "Wyrażenia").

  • Metoda wprowadzona w klasie lub strukturze ukrywa właściwości, pola i typy, które współużytkują tę nazwę w klasie podstawowej.Ukrywa wszystkie metody klasy podstawowej, które mają taki sam podpis.

  • Indeksator wprowadzony w klasie lub strukturze ukrywa wszystkie indeksatory klas podstawowych, które mają taki sam podpis.

Błędem jest korzystanie z obu modyfikatorów new i override dla tego samego członka, ponieważ ich znaczenia wzajemnie się wykluczają.Modyfikator new tworzy nowy element członkowski o tej samej nazwie i powoduje, że oryginalny element członkowski będzie ukryty.Modyfikator override rozszerza implementację dla odziedziczonego członka.

Używanie modyfikatora new w deklaracji, która nie ukrywa dziedziczonego elementu członkowskiego, generuje ostrzeżenie.

Przykład

W tym przykładzie klasa bazowa, BaseC i klasa pochodna, DerivedC, używają tej samej nazwy pola x, która ukrywa wartość odziedziczonego pola.Przykład demonstruje użycie modyfikatora new.Ilustruje też sposób dostępu do ukrytych członków klasy podstawowej za pomocą ich w pełni kwalifikowanych nazw.

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
*/

W tym przykładzie klasa zagnieżdżona ukrywa klasę, która ma taką samą nazwę w klasie podstawowej.W przykładzie pokazano, jak używać modyfikatora new, aby wyeliminować komunikat ostrzegawczy, i jak uzyskać dostęp do członków ukrytej klasy za pomocą ich w pełni kwalifikowanych nazw.

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
*/

Jeśli usuniesz modyfikator new, program się skompiluje i uruchomi, ale pojawi się następujące ostrzeżenie:

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

Specyfikacja języka C#

Aby uzyskać więcej informacji, zobacz Specyfikacja języka C#. Specyfikacja języka jest ostatecznym źródłem informacji o składni i użyciu języka C#.

Zobacz też

Informacje

Słowa kluczowe języka C#

Słowa kluczowe operatora (odwołanie w C#)

Modyfikatory (odwołanie w C#)

Przechowywanie wersji zastępowania i nowych słów kluczowych (Przewodnik programowania w języku C#)

Użycie zastępowania i nowych słów kluczowych (Przewodnik programowania w języku C#)

Koncepcje

Przewodnik programowania w języku C#

Inne zasoby

Odwołanie w C#