Basisklassenmethoden nicht ausblenden

     TypeName

DoNotHideBaseClassMethods

CheckId

CA1061

Kategorie

Microsoft.Design

Unterbrechende Änderung

Breaking

Ursache

Ein abgeleiteter Typ deklariert eine Methode mit demselben Namen und derselben Anzahl an Parametern als eine seiner Basismethoden. Mindestens einer der Parameter ist ein Basistyp des entsprechenden Parameters in der Basismethode. Alle verbleibenden Parameter weisen Typen auf, die mit den entsprechenden Parametern in der Basismethode identisch sind.

Regelbeschreibung

Eine Methode in einem Basistyp wird durch eine Methode mit identischem Namen in einem abgeleiteten Typ verdeckt, wenn die Parametersignatur der abgeleiteten Methode sich nur hinsichtlich der Typen unterscheidet, die schwächer abgeleitet sind als die entsprechenden Typen in der Parametersignatur der Basismethode.

Behandlung von Verstößen

Um einen Verstoß gegen diese Regel zu behandeln, können Sie die Methode entfernen oder umbenennen oder die Parametersignatur so ändern, dass die Basismethode von der Methode nicht verdeckt wird.

Warnungsausschluss

Schließen Sie keine Warnung dieser Regel aus.

Beispiel

Im folgenden Beispiel wird eine Methode veranschaulicht, die gegen die Regel verstößt.

using System;
  
namespace DesignLibrary
{
   class BaseType
   {
      internal void MethodOne(string inputOne, object inputTwo)
      {
         Console.WriteLine("Base: {0}, {1}", inputOne, inputTwo);
      }

      internal void MethodTwo(string inputOne, string inputTwo)
      {
         Console.WriteLine("Base: {0}, {1}", inputOne, inputTwo);
      }
   }

   class DerivedType : BaseType
   {
      internal void MethodOne(string inputOne, string inputTwo)
      {
         Console.WriteLine("Derived: {0}, {1}", inputOne, inputTwo);
      }

      // This method violates the rule.
      internal void MethodTwo(string inputOne, object inputTwo)
      {
         Console.WriteLine("Derived: {0}, {1}", inputOne, inputTwo);
      }
   }

   class Test
   {
      static void Main()
      {
         DerivedType derived = new DerivedType();

         // Calls DerivedType.MethodOne.
         derived.MethodOne("string1", "string2");

         // Calls BaseType.MethodOne.
         derived.MethodOne("string1", (object)"string2");

         // Both of these call DerivedType.MethodTwo.
         derived.MethodTwo("string1", "string2");
         derived.MethodTwo("string1", (object)"string2");
      }
   }
}