Wie ein Decompiler eine kovariante Überschreibung liest
C# 9 erlaubt es, dass eine Überschreibung einen abgeleiteteren Typ zurückgibt, doch die CLR hat keinen Slot für eine Methode, deren Signatur von der überschriebenen abweicht. Der Compiler kaschiert das mit einem expliziten .override und einem PreserveBaseOverrides-Marker – genau das liest Glass.NET, um eine kovariante Überschreibung von einer expliziten Schnittstellenimplementierung zu unterscheiden.
C# 9 erlaubte es, die Überschreibung zu schreiben, die sich alle zwanzig Jahre lang gewünscht hatten: ein Clone() auf Dog, das Dog zurückgibt, nicht Animal. Es liest sich wie eine Belanglosigkeit. Darunter ist es einer der wenigen Orte, an denen der C#-Compiler Metadaten ausgeben muss, die die normalen Überschreibungsregeln der CLR verbieten, und dann das Verhalten der Runtime mit einem Attribut flickt, um es sicher zu machen. Für jeden, der eine kompilierte Assembly liest, sieht eine kovariante Überschreibung beunruhigend aus wie eine explizite Schnittstellenimplementierung – dieselbe .override-Direktive, dieselbe ungewöhnliche Form – und die beiden zu verwechseln erzeugt dekompilierten Code, der nicht kompiliert. Sie zu unterscheiden ist ein reines Metadatenproblem und ein gutes Fenster dafür, wie ein Decompiler über die vtable nachdenkt.
Die eigentliche Frage
Die CLR paart eine virtuelle Überschreibung mit der Methode, die sie überschreibt, indem sie Name und vollständige Signatur, einschließlich Rückgabetyp, abgleicht. Das ist der ganze Grund, warum Überschreiben „einfach funktioniert” ohne jegliche explizite Verdrahtung. Eine kovariante Überschreibung bricht die Regel mit Absicht: Dog Clone() und Animal Clone() haben unterschiedliche Rückgabetypen, also sind sie nach der Standardlogik der Runtime zwei verschiedene Methoden in zwei verschiedenen vtable-Slots. Dennoch verlangt die Sprache, dass der Aufruf von Clone() über eine Animal-Referenz bei Dog.Clone() landet. Irgendetwas muss den Slot der Basis für eine Methode zurückgewinnen, die die Runtime andernfalls als unverwandt betrachten würde.
Die Frage, die Glass beantwortet, lautet also nicht „was tut diese Überschreibung”, sondern „gewinnt diese .override-Zeile einen vtable-Slot einer Basisklasse für einen abgeleiteteren Rückgabetyp zurück, oder implementiert sie eine Schnittstellenmethode?” Es ist dieselbe Direktive, die auf zwei verschiedene Arten von Zielen zeigt, und nur die Metadaten des Ziels unterscheiden sie.
Was der Compiler tatsächlich ausgibt
Beginnen wir mit dem Code, den jeder schreibt:
public class Animal
{
public virtual Animal Clone() => new Animal();
}
public class Dog : Animal
{
public override Dog Clone() => new Dog();
}
Dog.Clone gibt Dog zurück. In IL behält die Methode den Namen und die Virtualität der Basis bei, kann den Slot aber nicht per Signatur wiederverwenden, weil die Signatur abweicht. Der Compiler gibt drei Dinge aus, die eine normale Überschreibung nie braucht:
.method public hidebysig virtual instance class Dog
Clone() cil managed
{
.custom instance void [System.Runtime]System.Runtime.CompilerServices.PreserveBaseOverridesAttribute::.ctor() = ( 01 00 00 00 )
.override method instance class Animal Animal::Clone()
newobj instance void Dog::.ctor()
ret
}
Lesen Sie die drei Marker der Reihe nach. Erstens ist der Rückgabetyp in der .method-Zeile Dog, nicht Animal – das ist das gesamte Feature, direkt dort in der Signatur sichtbar. Zweitens benennt die .override-Direktive Animal::Clone() explizit; das ist eine Zeile in der MethodImpl-Tabelle, derselben Tabelle, die explizite Schnittstellenimplementierungen festhält. Sie sagt „dieser Rumpf implementiert jenen Slot” und überschreibt damit von Hand die signaturbasierte Paarung der Runtime. Drittens ist [PreserveBaseOverrides] auf die Methode gestempelt, damit die Runtime auch nach einer erneuten Ableitung durch eine weitere Unterklasse den am stärksten abgeleiteten Rumpf in diesem Slot auflöst.
Das entscheidende Detail für einen Decompiler: Es gibt kein newslot. Die Methode verwendet den Basis-Slot absichtlich wieder. Eine explizite Schnittstellenimplementierung hingegen lebt in ihrem eigenen Slot und ist private final newslot virtual. Dieses eine Flag plus das, worauf das .override zeigt, ist der Großteil der Antwort.
Die Rekonstruktions-Heuristik
Glass behandelt jede MethodImpl-Zeile als eine Verzweigung. Damit die Zeile als kovariantes override dargestellt wird, müssen vier Tatsachen zusammen zutreffen – direkt aus den Metadaten gelesen, ohne zu raten:
- Die überschriebene Methode lebt auf einer Basis-Klasse, nicht auf einer Schnittstelle. Lösen Sie das Ziel des
.overrideauf; ist sein deklarierender Typ eine Schnittstelle, handelt es sich um eine explizite Schnittstellenimplementierung und der kovariante Pfad endet sofort. - Die implementierende Methode und das Ziel teilen Name und Parameterliste.
Clone()zuClone(), identische Parameter. Eine kovariante Überschreibung kann nicht umbenennen; eine Abweichung hier bedeutet, dass etwas anderes vor sich geht. - Der Rückgabetyp der implementierenden Methode ist dem Rückgabetyp des Ziels zuweisbar.
Dogleitet vonAnimalab, also istDogein legaler kovarianter Rückgabewert für einen mitAnimaltypisierten Slot. Glass durchläuft die Basistyp-Kette (und, für kovariant zurückgegebene Schnittstellen, die Menge der implementierten Schnittstellen), um die Beziehung zu bestätigen. Sind die Rückgabetypen identisch, ist keine Kovarianz im Spiel und die Methode hätte überhaupt kein explizites.overridegebraucht – was selbst ein Signal ist, dass die Zeile etwas Ungewöhnliches bedeutet. - Die Methode verwendet den Basis-Slot wieder (kein
newslot) und ist mit[PreserveBaseOverrides]markiert. Das ist der eigene Fingerabdruck der Runtime für dieses Feature. Seine Anwesenheit macht aus einer plausiblen Übereinstimmung eine sichere.
Wenn alle vier zutreffen, lässt Glass die .override-Direktive und das Attribut aus dem gedruckten Quelltext weg – sie sind Buchführung von Compiler und Runtime, nicht die Absicht des Autors – und gibt die saubere Zeile aus, die der Entwickler tatsächlich geschrieben hat:
public override Dog Clone() => new Dog();
Das Attribut und das MethodImpl bleiben in der IL-Ansicht für jeden sichtbar, der sie sehen will; sie gehören einfach nicht in rekonstruiertes C#, denn sie von Hand erneut auszugeben wäre bestenfalls redundant und schlimmstenfalls ein Kompilierfehler.
Wenn es stattdessen eine Schnittstellenimplementierung ist
Dieselbe Form erscheint, wenn eine Klasse eine Schnittstellenmethode mit anderer Zugänglichkeit implementiert oder um zwei Schnittstellen zu entflechten:
public interface ICloneableAnimal { Animal Clone(); }
public class Cat : ICloneableAnimal
{
Animal ICloneableAnimal.Clone() => new Cat(); // explizite Implementierung
}
Hier zielt das MethodImpl auf ICloneableAnimal::Clone, die Methode ist private final newslot virtual, und es gibt kein [PreserveBaseOverrides]. Die Schritte 1 und 4 scheitern beide. Glass stellt sie als Animal ICloneableAnimal.Clone() dar, vollständig qualifiziert, was das einzige legale C# für ein explizites Schnittstellenmitglied ist. Die beiden zu verwechseln ist der klassische Decompiler-Fehler: eine kovariante Überschreibung als explizite Implementierung zu drucken benennt ein Mitglied, das nicht existiert; eine explizite Implementierung als einfache Überschreibung zu drucken ändert ihre Zugänglichkeit und bricht den Typ.
Vorbehalte und die ehrliche Grenze
Kovariante Rückgaben funktionieren auch, wenn der Rückgabetyp eine Schnittstelle ist, die der Rückgabetyp der abgeleiteten Methode implementiert, sowie über generische Instanziierungen hinweg – Glass behandelt beide, indem es die Zuweisbarkeit aus Schritt 3 über die Schnittstellenmenge auflöst, nicht nur über die Basisklassenkette. Das Feature ist außerdem runtime-gesteuert: Es erfordert RuntimeFeature.CovariantReturnsOfClasses, was bedeutet, dass es nur in Assemblies auftaucht, die auf .NET 5+ zielen. Auf älteren Zielen wurde dieselbe Absicht mit einem handgeschriebenen protected virtual Animal CloneCore() plus einem new Dog Clone()-Schatten ausgedrückt, und Glass zeigt Ihnen getreu dieses Muster: Es kann keine kovariante Überschreibung erfinden, die der Compiler nie ausgegeben hat.
Der einzige wirklich unentscheidbare Fall ist eine explizite Überschreibung, die zugleich umbenennt und den Rückgabetyp über nicht-öffentliche MethodImpl-Verrohrung verengt, die eine andere Sprache als C# ausgegeben hat. Es gibt keine C#-Syntax, die zugleich umbenennt und kovariant überschreibt, also greift Glass auf die explizite, vollständig qualifizierte Form zurück. Das hält die Ausgabe kompilierbar – die Regel, die stets über Eleganz siegt.
Fazit
Eine kovariante Überschreibung ist das seltene C#-Feature, das sich im gewöhnlichen Überschreibungsmodell der CLR nicht ausdrücken lässt, also greift der Compiler zur selben expliziten Überschreibungs-Maschinerie, die Schnittstellen verwenden, und stabilisiert sie dann mit [PreserveBaseOverrides]. Ein Decompiler, der nur die .override-Direktive liest, verwechselt sie mit einer Schnittstellenimplementierung; Glass.NET liest das, worauf die Direktive zielt – eine Basisklasse, eine Obertyp-Rückgabe, einen wiederverwendeten Slot – und rekonstruiert die eine saubere override-Zeile, die der Autor geschrieben hat, und lässt die Buchführung der Runtime dort, wo sie hingehört, in der IL-Ansicht. Zu wissen, welche dieser beiden Lesarten Sie vor sich haben, ist der Unterschied zwischen dekompiliertem Code, der sich neu bauen lässt, und dekompiliertem Code, der nur plausibel aussieht.
Nebula.NET testen
Härten Sie Ihren .NET-Code in wenigen Minuten — starten Sie mit der kostenlosen Edition.