[OverloadResolutionPriority] dekompilieren: eine Compile-Zeit-Entscheidung, in der Aufrufstelle eingefroren
Das Attribut OverloadResolutionPriority steuert die Überladungsauflösung, markiert aber nur die Methodendefinition, nie den Aufruf. So liest Glass.NET beide Seiten.
C# 13 fügte den Regeln der Überladungsauflösung ein kleines, scharfes Werkzeug hinzu: [OverloadResolutionPriority]. Man setzt es auf ein Member einer Überladungsgruppe und gibt ihm eine Ganzzahl; unter den Kandidaten, die der Compiler bereits als anwendbar betrachtet, gewinnt derjenige mit der höchsten Priorität und überschreibt die üblichen „Welche ist besser”-Stichentscheide. Das BCL von .NET 9 nutzt es, damit span-basierte Überladungen still den Vorrang vor ihren älteren array- und string-basierten Geschwistern erhalten, sodass bestehende Aufrufstellen beim bloßen Neukompilieren den schnelleren Pfad binden — ohne Quellcodeänderung und ohne Mehrdeutigkeitsfehler.
Es ist zudem ein wirklich interessantes Dekompilierungsproblem, und zwar aus dem entgegengesetzten Grund wie die meisten Konstrukte, über die wir geschrieben haben. Das Schlüsselwort field ist in den Metadaten unsichtbar und nur im IL des Zugriffsmethoden-Körpers sichtbar. [OverloadResolutionPriority] ist das Gegenteil: Es ist auf der Definition perfekt sichtbar und an der Aufrufstelle vollständig unsichtbar. Das Attribut ist eine Compile-Zeit-Direktive, deren einzige Aufgabe es ist, eine Entscheidung zu lenken, und sobald diese Entscheidung gefallen ist, hinterlässt es keinen Fingerabdruck im Code, der davon profitiert hat. Dieser Beitrag zeigt die Metadaten, die es schreibt, den Aufrufstellen-IL, den es nicht schreibt, und wie Glass.NET jede Seite als das liest, was sie wirklich ist.
Die Überladungsgruppe und das Attribut
Hier ist die Form, die das BCL in .NET 9 dutzendfach übernommen hat: eine ältere Überladung, die ein Array nimmt, und eine neuere, schnellere, die einen ReadOnlySpan<T> nimmt. Beide sind anwendbar, wenn man ein Array übergibt, denn es gibt eine implizite Array-zu-Span-Konvertierung. Historisch gewann die Array-Überladung (sie ist eine exakte Übereinstimmung), sodass ein Neukompilieren nie auf den Span-Pfad wechselte. Das Attribut kehrt das um:
using System;
using System.Runtime.CompilerServices;
public static class Sink
{
[OverloadResolutionPriority(1)]
public static void Add(ReadOnlySpan<int> items) { /* fast path */ }
public static void Add(int[] items) { /* legacy path */ }
}
OverloadResolutionPriorityAttribute liegt in System.Runtime.CompilerServices und wird im Wesentlichen so deklariert:
[AttributeUsage(AttributeTargets.Method | AttributeTargets.Constructor
| AttributeTargets.Property, AllowMultiple = false, Inherited = false)]
public sealed class OverloadResolutionPriorityAttribute : Attribute
{
public OverloadResolutionPriorityAttribute(int priority) => Priority = priority;
public int Priority { get; }
}
Die Priorität ist ein gewöhnlicher int; der Standardwert (alles Unmarkierte) ist 0, und negative Werte verringern die Priorität eines Members. Die Regel gilt nur zwischen Kandidaten, die im selben Typ deklariert sind, und erst, nachdem der Compiler die Menge auf die anwendbaren reduziert hat: Sie ist ein finaler Stichentscheid, kein Weg, etwas aufzurufen, das sonst nicht binden würde.
Was das Attribut in die Metadaten schreibt
Auf Add(ReadOnlySpan<int>) angewendet, kompiliert das Attribut zu einem einzigen benutzerdefinierten Attribut-Eintrag, der an dieser Methode hängt:
.method public hidebysig static void Add(valuetype [System.Runtime]System.ReadOnlySpan`1<int32> items) cil managed
{
.custom instance void [System.Runtime]System.Runtime.CompilerServices.OverloadResolutionPriorityAttribute::.ctor(int32)
= ( 01 00 01 00 00 00 00 00 )
// ...
}
Der Blob wird genau so dekodiert wie der jedes Attributs mit einem einzigen int32-Argument. Das führende 01 00 ist der feste Prolog. Die nächsten vier Bytes 01 00 00 00 sind das int32-Argument in Little-Endian: der Wert 1. Die abschließenden 00 00 besagen, dass es null benannte Argumente gibt. Nichts Konstrukt-Spezifisches hier: Es ist dieselbe Zeile der Tabelle CustomAttribute (0x0C), die auch [Obsolete] oder [MethodImpl] erzeugen würden, nur mit anderer Type-Spalte (dem .ctor des Attributs) und anderem Value-Blob.
Das ist der gesamte Metadaten-Fußabdruck. Glass liest die Zeile, löst das Type-Token zu OverloadResolutionPriorityAttribute auf, dekodiert den Blob gegen die Konstruktorsignatur und druckt das Attribut wortgetreu über der Methode zurück. Da das Attribut gewöhnlich ist, ist der Hin- und Rückweg sauber: Was Sie dekompilieren, ist, was der Autor geschrieben hat, Prioritätswert inklusive. Sie können die rohen Bytes selbst im Metadaten-Panel von Glass prüfen, das die CustomAttribute-Zeile mit ihrem Parent-Token und dem wörtlichen Blob zeigt, direkt neben dem gerenderten C#.
Die Aufrufstelle, wo das Attribut keine Spur hinterlässt
Nun die interessante Hälfte. Hier ist Code, der die Gruppe mit einem Array-Argument aufruft:
Sink.Add(new[] { 1, 2, 3 });
Wegen der Priorität bindet der Compiler dies an die Span-Überladung und fügt die implizite Array-zu-Span-Konvertierung ein. Der emittierte IL:
ldc.i4.3
newarr [System.Runtime]System.Int32
dup
ldc.i4.0
ldc.i4.1
stelem.i4
// … stelem.i4 for elements 1 and 2 …
call valuetype [System.Runtime]System.ReadOnlySpan`1<int32>
[System.Runtime]System.ReadOnlySpan`1<int32>::op_Implicit(!0[])
call void Sink::Add(valuetype [System.Runtime]System.ReadOnlySpan`1<int32>)
Vergleichen Sie das mit dem IL, den Sie vor der Existenz des Attributs bekommen hätten, als die Array-Überladung gewann:
ldc.i4.3
newarr [System.Runtime]System.Int32
dup
ldc.i4.0
ldc.i4.1
stelem.i4
// … stelem.i4 for elements 1 and 2 …
call void Sink::Add(int32[])
Die beiden unterscheiden sich nur darin, welches Sink::Add genannt wird, plus dem op_Implicit-Aufruf, den der Span-Pfad braucht. Keiner der beiden IL-Ströme enthält irgendeinen Verweis auf OverloadResolutionPriority. Das Attribut hat seine Arbeit vollständig zur Compile-Zeit getan: Es neigte die Auflösung, die Auflösung erzeugte einen gebundenen Aufruf, und der gebundene Aufruf ist alles, woran sich der IL erinnert. Beim Lesen des Aufrufers kann ein Dekompilierer nicht sagen „hier wurde eine Überladungsauflösungs-Priorität konsultiert” — es gibt nichts zu lesen. Er kann nur die Methode melden, die tatsächlich aufgerufen wurde.
Warum „treu zum IL” das richtige Verhalten ist
Es wäre verlockend, sich einen Dekompilierer vorzustellen, der beim Anblick eines Aufrufs der Span-Überladung „hilfsbereit” den op_Implicit wegvereinfacht und Sink.Add(new[] { 1, 2, 3 }) zeigt, als wäre nichts Besonderes passiert. Glass tut genau das auf Quellcode-Ebene — es rendert den natürlichen C#-Aufruf, denn das hat der Autor geschrieben — aber es tut es, indem es den gebundenen Aufruf dekompiliert, den es vorgefunden hat, und nicht, indem es die Überladungsauflösung erneut ausführt. Dieser Unterschied zählt.
Würde Glass die Überladung beim Rendern des Aufrufers von Grund auf neu auflösen, müsste es die Priorität kennen, um die ursprüngliche Bindung zu reproduzieren. Attribute werden in Referenz-Assemblys bewahrt, also ist die Information meist vorhanden — aber ein Dekompilierer, der von Neuauflösung abhängt, ist nur eine schlechte Eingabe (ein entferntes Attribut, ein nicht passender Referenzsatz) davon entfernt, den Aufruf still an die Array-Überladung neu zu binden und Quellcode zu erzeugen, der zu anderem IL kompiliert. Indem es den Instruktionsstrom dekompiliert, den der Compiler tatsächlich emittiert hat, umgeht Glass die ganze Frage: Das gewählte Ziel und seine Konvertierung sind Fakten im IL, und Glass meldet Fakten. Das Prioritätsattribut wird dort gerendert, wo es lebt — auf der Definition — und die Aufrufstelle wird als der konkrete Aufruf gezeigt, der sie ist.
In der Praxis lesen
Richten Sie Glass auf das Assembly, und zwei Dinge fallen klar heraus. Auf dem Typ Sink trägt die Span-Überladung [OverloadResolutionPriority(1)] genau wie geschrieben, und das Metadaten-Panel zeigt die zugrunde liegende CustomAttribute-Zeile, falls Sie den Blob sehen wollen. Bei jedem Aufrufer sehen Sie den gewöhnlichen, gebundenen Aufruf — an die Span-Überladung, mit der Array-zu-Span-Konvertierung inline — und keine Erwähnung der Priorität, denn es wurde keine emittiert. Über die CLI erscheint dieselbe Aufteilung im exportierten Quellcode:
glass decompile Sink.dll --type Sink --member Add
glass decompile App.dll --type Program --member Main
Der erste druckt das Attribut auf der Definition; der zweite druckt den aufgelösten Aufruf ohne irgendein Attribut in der Nähe. Diese Asymmetrie ist kein Mangel des Werkzeugs: Sie ist ein ehrliches Bild dessen, was [OverloadResolutionPriority] ist — eine Compile-Zeit-Anweisung, die eine Absicht auf der Definition dokumentiert und den Rest des Programms im Unklaren lässt. Es zurückzulesen hat weniger mit Rekonstruktion zu tun als damit, zu wissen, welche Hälfte des Binaries man betrachten muss, und dem IL für die andere zu vertrauen.
Nebula.NET testen
Härten Sie Ihren .NET-Code in wenigen Minuten — starten Sie mit der kostenlosen Edition.